WAVEOUTCAPSA structure (mmeapi.h)
The WAVEOUTCAPS structure describes the capabilities of a waveform-audio output device.
Syntax
typedef struct tagWAVEOUTCAPSA {
WORD wMid;
WORD wPid;
MMVERSION vDriverVersion;
CHAR szPname[MAXPNAMELEN];
DWORD dwFormats;
WORD wChannels;
WORD wReserved1;
DWORD dwSupport;
} WAVEOUTCAPSA, *PWAVEOUTCAPSA, *NPWAVEOUTCAPSA, *LPWAVEOUTCAPSA;
Members
wMid
Manufacturer identifier for the device driver for the device. Manufacturer identifiers are defined in Manufacturer and Product Identifiers.
wPid
Product identifier for the device. Product identifiers are defined in Manufacturer and Product Identifiers.
vDriverVersion
Version number of the device driver for the 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) output.
wReserved1
dwSupport
Optional functionality supported by the device. The following values are defined:
| Flag | Description |
|---|---|
| WAVECAPS_LRVOLUME | Supports separate left and right volume control. |
| WAVECAPS_PITCH | Supports pitch control. |
| WAVECAPS_PLAYBACKRATE | Supports playback rate control. |
| WAVECAPS_SYNC | The driver is synchronous and will block while playing a buffer. |
| WAVECAPS_VOLUME | Supports volume control. |
| WAVECAPS_SAMPLEACCURATE | Returns sample-accurate position information. |
Remarks
If a device supports volume changes, the WAVECAPS_VOLUME flag will be set for the dwSupport member. If a device supports separate volume changes on the left and right channels, both the WAVECAPS_VOLUME and the WAVECAPS_LRVOLUME flags will be set for this member.
Note
The mmeapi.h header defines WAVEOUTCAPS as an alias which 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 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) |