WAVEINCAPSA structure (mmeapi.h)
The WAVEINCAPS structure describes the capabilities of a waveform-audio input device.
Syntax
typedef struct tagWAVEINCAPSA {
WORD wMid;
WORD wPid;
MMVERSION vDriverVersion;
CHAR szPname[MAXPNAMELEN];
DWORD dwFormats;
WORD wChannels;
WORD wReserved1;
} WAVEINCAPSA, *PWAVEINCAPSA, *NPWAVEINCAPSA, *LPWAVEINCAPSA;
Members
wMid
Manufacturer identifier for the device driver for the waveform-audio input device. Manufacturer identifiers are defined in Manufacturer and Product Identifiers.
wPid
Product identifier for the waveform-audio input device. Product identifiers are defined in Manufacturer and Product Identifiers.
vDriverVersion
Version number of the device driver for the waveform-audio input device. The high-order byte is the major version number, and the low-order byte is the minor version number.
szPname[MAXPNAMELEN]
Product name in a null-terminated string.
dwFormats
Standard formats that are supported. Can be a combination of the following:
| Format | Description |
|---|---|
| WAVE_FORMAT_1M08 | 11.025 kHz, mono, 8-bit |
| WAVE_FORMAT_1M16 | 11.025 kHz, mono, 16-bit |
| WAVE_FORMAT_1S08 | 11.025 kHz, stereo, 8-bit |
| WAVE_FORMAT_1S16 | 11.025 kHz, stereo, 16-bit |
| WAVE_FORMAT_2M08 | 22.05 kHz, mono, 8-bit |
| WAVE_FORMAT_2M16 | 22.05 kHz, mono, 16-bit |
| WAVE_FORMAT_2S08 | 22.05 kHz, stereo, 8-bit |
| WAVE_FORMAT_2S16 | 22.05 kHz, stereo, 16-bit |
| WAVE_FORMAT_4M08 | 44.1 kHz, mono, 8-bit |
| WAVE_FORMAT_4M16 | 44.1 kHz, mono, 16-bit |
| WAVE_FORMAT_4S08 | 44.1 kHz, stereo, 8-bit |
| WAVE_FORMAT_4S16 | 44.1 kHz, stereo, 16-bit |
| WAVE_FORMAT_96M08 | 96 kHz, mono, 8-bit |
| WAVE_FORMAT_96M16 | 96 kHz, mono, 16-bit |
| WAVE_FORMAT_96S08 | 96 kHz, stereo, 8-bit |
| WAVE_FORMAT_96S16 | 96 kHz, stereo, 16-bit |
wChannels
Number specifying whether the device supports mono (1) or stereo (2) input.
wReserved1
Remarks
Note
The mmeapi.h header defines WAVEINCAPS as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Header | mmeapi.h (include Windows.h) |