AAM_GetSourceCap

This function returns the capabilities of a specified audio source.

Syntax

DWORD AAM_GetSourceCap( IN DWORD dwIndex, OUT AAM_SRCCAP *pASC );

Parameters

dwIndex

Specifies the index of the audio source. It is one of the following flags:

Flag	Value	Description
AAM_SRC_BYID	0x00000000	Use the audio source identifier.
AAM_SRC_BYINDEX	0x80000000	Specifies the source with an index ranging from 0 to GetNumSources minus 1; in other words, use the bitwise OR to combine the index with the flag.

pASC

Pointer to an AAM_SRCCAP structure to hold the returned information.

Return Values

Zero indicates success. AAM_ERR_INVALIDPARAM indicates an invalid parameter

Remarks

This function is part of the audio source control API.

The main use of this function is to get an audio source identifier, which the application uses to select the source. An application can get the AAM_SRCCAP structure of a particular audio source and check the m_dwinfo member of that structure. If AAM_FLAG_SELECTED is set, then that audio source is active.