WAVEOUTCAPS

A version of this page is also available for

Windows Embedded CE 6.0 R3

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

See Also

Reference

Waveform Audio Structures