WAVEOUTCAPS (Windows CE 5.0)

  • Article

Send Feedback

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.

  • 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 CE, they are rarely needed or used because embedded devices typically have built-in devices with built-in drivers.

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Mmsystem.h.

See Also

Waveform Audio Structures

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.