Export (0) Print
Expand All

WAVEOUTCAPS

Windows Mobile 6.5
A version of this page is also available for
4/8/2010

This structure describes the capabilities of a waveform-audio output device.


typedef struct {
  WORD wMid; 
  WORD wPid; 
  MMVERSION vDriverVersion; 
  CHAR szPname[MAXPNAMELEN]; 
  DWORD dwFormats; 
  WORD wChannels; 
  WORD wReserved1; 
  DWORD dwSupport;
} WAVEOUTCAPS; 

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.

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.

Headermmsystem.h
Windows Embedded CEWindows CE 2.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions

ADD
Show:
© 2014 Microsoft