WAVEOUTCAPS

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; 

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
    Null-terminated string that contains the product name.

  • 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. It is one of the following flags:

    Value 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 blocks 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 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

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later Mmsystem.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.