WAVEOUTCAPS (Compact 2013)
3/26/2014
This structure describes the capabilities of a waveform-audio output device.
Syntax
typedef struct tagWAVEOUTCAPS {
WORD wMid;
WORD wPid;
MMVERSION vDriverVersion;
TCHAR szPname[MAXPNAMELEN];
DWORD dwFormats;
WORD wChannels;
WORD wReserved1;
DWORD dwSupport;
} WAVEOUTCAPS;
Members
- wMid
Manufacturer identifier for the device driver for the device.
- wPid
Product identifier for the device.
- 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
Null-terminated string that contains the product name.The length of szPname is defined by the following macro in Mmsystem.h:
#define MAXPNAMELEN 32 /* max product name length (including NULL) */
dwFormats
Specifies the standard waveform audio formats that are supported. It can be one or a combination of the following flags.Flag
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
- wChannels
Number specifying whether the device supports mono or stereo output. Set to 1 to indicate mono output; set to 2 to indicate stereo output.
- wReserved1
A packsize value that specifies the compiler’s data alignment requirements for the size of the structure.
dwSupport
Specifies the optional functionality supported by the device. The following table shows the possible values.Value
Description
WAVECAPS_LRVOLUME
Supports separate left and right volume control.
WAVECAPS_PITCH
Supports pitch control.
WAVECAPS_PLAYBACKRATE
Supports playback rate control.
WAVECAPS_VOLUME
Supports volume control.
WAVECAPS_SAMPLEACCURATE
Returns sample-accurate position information.
Remarks
If a device supports volume changes, the WAVECAPS_VOLUME flag is 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 are set for this member.
Requirements
Header |
mmsystem.h |