auxGetDevCaps
The auxGetDevCaps function retrieves the capabilities of a given auxiliary output device.
MMRESULT auxGetDevCaps( UINT_PTR uDeviceID, LPAUXCAPS lpCaps, UINT cbCaps );
Parameters
uDeviceID
Identifier of the auxiliary output device to be queried. Specify a valid device identifier (see the following comments section), or use the following constant:
| Value | Meaning |
| AUX_MAPPER | Auxiliary audio mapper. The function returns an error if no auxiliary audio mapper is installed. |
lpCaps
Pointer to an AUXCAPS structure to be filled with information about the capabilities of the device.
cbCaps
Size, in bytes, of the AUXCAPS structure.
Return Values
Returns MMSYSERR_NOERROR if successful or an error otherwise. Possible error values include the following.
| Value | Description |
| MMSYSERR_BADDEVICEID | Specified device identifier is out of range. |
Remarks
The device identifier in uDeviceID varies from zero to one less than the number of devices present. AUX_MAPPER may also be used. Use the auxGetNumDevs function to determine the number of auxiliary output devices present in the system.
Requirements
Windows NT/2000/XP: Included in Windows NT 3.1 and later.
Windows 95/98/Me: Included in Windows 95 and later.
Header: Declared in Mmsystem.h; include Windows.h.
Library: Use Winmm.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000/XP.
See Also
