Edit

WAVEOUTCAPS structure (mmeapi.h)

  • Article

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

Syntax

typedef struct waveoutcaps_tag {
  WORD    wMid;
  WORD    wPid;
  VERSION vDriverVersion;
  char    szPname[MAXPNAMELEN];
  DWORD   dwFormats;
  WORD    wChannels;
  DWORD   dwSupport;
} WAVEOUTCAPS, *PWAVEOUTCAPS, *NPWAVEOUTCAPS, *LPWAVEOUTCAPS;

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.

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.

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)

See also

Waveform Audio

Waveform Structures