waveInGetDevCaps

Syntax

WORD waveInGetDevCaps(wDeviceID, lpCaps, wSize)

This function queries a specified waveform input device to determine its capabilities.

Parameters

WORD wDeviceID

Identifies the waveform input device.

LPWAVEINCAPS lpCaps

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

WORD wSize

Specifies the size of the WAVEINCAPS structure.

Return Value

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

MMSYSERR_BADDEVICEID

Specified device ID is out of range.

MMSYSERR_NODRIVER

The driver was not installed.

Comments

Use waveInGetNumDevs to determine the number of waveform input devices present
in the system. The device ID specified by wDeviceID varies from zero to one less than
the number of devices present. 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.

See Also

waveInGetNumDevs