waveOutGetDevCaps

	MMRESULT waveOutGetDevCaps(uDeviceID, lpCaps, wSize)
	UINT uDeviceID;
	LPWAVEOUTCAPS lpCaps;
	UINT wSize;

The waveOutGetDevCaps function queries a specified waveform device to determine its capabilities.

Parameters

uDeviceID

Identifies the waveform output device.

lpCaps

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

wSize

Specifies the size of the WAVEOUTCAPS 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 was not installed.

Comments

Use waveOutGetNumDevs to determine the number of waveform output devices present in the system. The device ID specified by uDeviceID varies from zero to one less than the number of devices present. The WAVE_MAPPER constant may also be used as a device id. Only wSize bytes (or less) of information is copied to the location pointed to by lpCaps. If wSize is zero, nothing is copied, and the function returns zero.