waveInGetDevCaps

	Overview

	Group

	Quick Info

The waveInGetDevCaps function retrieves the capabilities of a given waveform-audio input device.

MMRESULT waveInGetDevCaps(

UINT uDeviceID,
LPWAVEINCAPS pwic,
UINT cbwic
);

Parameters
uDeviceID

Identifier of the waveform-audio output device. It can be either a device identifier or a handle of an open waveform-audio input device.

pwic

Address of a WAVEINCAPS structure to be filled with information about the capabilities of the device.

cbwic

Size, in bytes, of the WAVEINCAPS structure.

Return Values
Returns MMSYSERR_NOERROR if successful or an error otherwise. Possible error values include the following:

MMSYSERR_BADDEVICEID	Specified device identifier is out of range.
MMSYSERR_NODRIVER	No device driver is present.
MMSYSERR_NOMEM	Unable to allocate or lock memory.

Remarks
Use this function to determine the number of waveform-audio input devices present in the system. If the value specified by the uDeviceID parameter is a device identifier, it can vary from zero to one less than the number of devices present. The WAVE_MAPPER constant can also be used as a device identifier. Only cbwic bytes (or less) of information is copied to the location pointed to by pwic. If cbwic is zero, nothing is copied and the function returns zero.