auxGetDevCaps

  MMRESULT auxGetDevCaps(wDeviceID, lpCaps, wSize)    
  UINT wDeviceID;    
  LPAUXCAPS lpCaps;    
  UINT wSize;    

The auxGetDevCaps function queries a specified auxiliary output device to determine its capabilities.

Parameters

wDeviceID

Identifies the auxiliary output device to be queried. Specify a valid device ID (see the following comments section), or use the following constant:

AUX_MAPPER

Auxiliary audio mapper. The function will return an error if no auxiliary audio mapper is installed.

lpCaps

Specifies a far pointer to an AUXCAPS structure. This structure is filled with information about the capabilities of the device.

wSize

Specifies the size of the AUXCAPS structure.

Return Value

Returns zero if the function was successful. Otherwise, it returns an error number. Possible error returns are:

Value Meaning

MMSYSERR_BADDEVICEID Specified device ID is out of range.
MMSYSERR_NODRIVER The driver failed to install.

Comments

The device ID specified by wDeviceID varies from zero to one less than the number of devices present. AUX_MAPPER may also be used. Use auxGetNumDevs to determine the number of auxiliary devices present in the system.

See Also

auxGetNumDevs