Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                 ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
WAVEOUTCAPS
 
        The WAVEOUTCAPS structure describes the capabilities of a
        waveform output device.
 
        typedef struct waveoutcaps_tag {
            UINT wMid;
            UINT wPid;
            VERSION vDriverVersion;
            char szPname[MAXPNAMELEN];
            DWORD dwFormats;
            UINT wChannels;
            DWORD dwSupport;
        } WAVEOUTCAPS;
 
Fields
        WORD wMid
            Specifies a manufacturer ID for the device driver for the
            waveform output device. Manufacturer IDs are defined in
            ◄Manufacturer and Product IDs►.
 
        WORD wPid
            Specifies a product ID for the waveform output device.
            Product IDs are defined in ◄Manufacturer and Product IDs►.
 
        VERSION vDriverVersion
            Specifies the version number of the device driver for the
            waveform output device. The high-order byte is the major
            version number, and the low-order byte is the minor version
            number. The numbering is up to the developer but should
            change with each driver release.
 
        char szPname[MAXPNAMELEN]
            Specifies the product name in a NULL-terminated string.
 
        DWORD dwFormats
            Specifies which standard formats are supported. The
            supported formats are specified with a logical OR of the
            following flags:
 
            WAVE_FORMAT_1M08
                11.025 kHz, Mono, 8-bit
 
            WAVE_FORMAT_1S08
                11.025 kHz, Stereo, 8-bit
 
            WAVE_FORMAT_1M16
                11.025 kHz, Mono, 16-bit
 
            WAVE_FORMAT_1S16
                11.025 kHz, Stereo, 16-bit
 
            WAVE_FORMAT_2M08
                22.05 kHz, Mono, 8-bit
 
            WAVE_FORMAT_2S08
                22.05 kHz, Stereo, 8-bit
 
            WAVE_FORMAT_2M16
                22.05 kHz, Mono, 16-bit
 
            WAVE_FORMAT_2S16
                22.05 kHz, Stereo, 16-bit
 
            WAVE_FORMAT_4M08
                44.1 kHz, Mono, 8-bit
 
            WAVE_FORMAT_4S08
                44.1 kHz, Stereo, 8-bit
 
            WAVE_FORMAT_4M16
                44.1 kHz, Mono, 16-bit
 
            WAVE_FORMAT_4S16
                44.1 kHz, Stereo, 16-bit
 
        WORD wChannels
            Specifies whether the device supports mono (1) or stereo (2)
            output.
 
        DWORD dwSupport
            Specifies optional functionality supported by the device.
 
            WAVECAPS_PITCH
                Supports pitch control.
 
            WAVECAPS_PLAYBACKRATE
                Supports playback rate control.
 
            WAVECAPS_SYNC
                Specifies that the driver is synchronous and will block
                while playing a buffer.
 
            WAVECAPS_VOLUME
                Supports volume control.
 
            WAVECAPS_LRVOLUME
                Supports separate left and right volume control.
 
Comments
        Drivers can support other formats in addition to those specified in
        the dwFormats field. If a device supports volume changes, the
        WAVECAPS_VOLUME flag will be set for the dwSupport
        field. 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 field.
 
See also
        waveOutGetDevCaps
 
                                       -♦-