WAVEOUTCAPS (Compact 2013)

  • Article

3/26/2014

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

Syntax

typedef struct tagWAVEOUTCAPS {
    WORD      wMid;
    WORD      wPid;
    MMVERSION vDriverVersion;
    TCHAR     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 waveform audio formats that are supported. It can be 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 or stereo output. Set to 1 to indicate mono output; set to 2 to indicate stereo output.
  • wReserved1
    A packsize value that specifies the compiler’s data alignment requirements for the size of the structure.

  • 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.

Requirements

Header

mmsystem.h

See Also

Reference

Waveform Audio Structures