waveInGetDevCapsEx(3mms) — Subroutines
Name
waveInGetDevCapsEx --- Query the specified waveform audio input device to determine its capabilities and its supported standard formats
Syntax
#include <mme/mme_api.h>
MMRESULT waveInGetDevCapsEx (UINT uClassDeviceID,
LPWAVEINCAPS lpCaps,
UINT wSize);
Arguments
UINT uClassDeviceID
Identifies the waveform audio input device.
LPWAVEINCAPS lpCaps
Specifies a pointer to a WAVEINCAPS data structure. This data structure is filled with information about the capabilities of the device.
The WAVEINCAPS data structure must be allocated with the mmeAllocMem function before being passed to the waveInGetDevCapsEx function. See the mmeAllocMem(3mms) reference page for more information about allocating memory for data structures.
UINT wSize
Specifies the size of the WAVEINCAPS data structure.
Description
The waveInGetDevCapsEx function queries the specified waveform audio input device to determine its capabilities. The device ID specified by the uClassDeviceID argument varies from zero to one fewer than the number of devices present. The WAVE_MAPPER constant can also be used as a device ID. (Use the waveInGetNumDevs function to determine the number of waveform audio input devices present in the system.)
Only wSize bytes (or fewer) of information is copied to the location pointed to by the lpCaps argument. If the value of the wSize argument is zero, nothing is copied and the function returns MMSYSERR_NOERROR.
The dwFormats field of the WAVEINCAPS data structure will return all the standard formats supported by the device. See Chapter 3 of the Programmer’s Guide for more information about specifying this waveform audio format.
Extensions
The waveInGetDevCapsEx function is a Digital extension to the Microsoft multimedia API specification.
Return Values
Returns MMSYSERR_NOERROR if the function is successful; otherwise, it returns one of the following error codes:
MMSYSERR_BADDEVICEID@T{ The specified device ID is out of range. T} MMSYSERR_NODRIVER@T{ No waveIn driver is installed. T} MMSYSERR_INVALPARAM@T{ The size of the WAVEINCAPS data structure is invalid. T}