WAVEOUTCAPS
A version of this page is also available for
4/8/2010
This structure describes the capabilities of a waveform-audio output device.
Syntax
typedef struct {
WORD wMid;
WORD wPid;
MMVERSION vDriverVersion;
CHAR 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 formats that are supported. It is 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 (1) or stereo (2) output.
- wReserved1
Packing.
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.
Manufacturer and product identifiers are used in Windows-based desktop systems to allow applications to determine which devices are installed on a host computer. Although these identifiers are supported in Windows Embedded CE, they are rarely needed or used because embedded devices typically have built-in devices with built-in drivers.
Requirements
| Header | mmsystem.h |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |