WAVEINCAPS

The WAVEINCAPS structure describes the capabilities of a waveform input device.

typedef struct waveincaps_tag {

UINT wMid;

UINT wPid;

VERSION vDriverVersion;

char szPname[MAXPNAMELEN];

DWORD dwFormats;

UINT wChannels;

} WAVEINCAPS;

Fields

The WAVEINCAPS structure has the following fields:

wMid

Specifies a manufacturer ID for the device driver for the waveform input device. Manufacturer IDs are defined in the Multimedia Programmer's Reference in the Microsoft Windows Software Development Kit.

wPid

Specifies a product ID for the waveform input device. Product IDs are defined in the Multimedia Programmer's Reference in the Microsoft Windows Software Development Kit.

vDriverVersion

Specifies the version number of the device driver for the waveform input 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 driver developer but should be changed with each driver release.

szPname[MAXPNAMELEN]

Specifies the product name in a NULL-terminated string.

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

wChannels

Specifies whether the device supports mono (1) or stereo (2) input.

Comments

Drivers can support other formats in addition to those specified in the dwFormats field.

See Also

waveInGetDevCaps