SoundTestWaveDevice

int
    SoundTestWaveDevice(
        IN PDEVICE_OBJECT pDO
        );

The SoundTestWaveDevice function initiates a short DMA transfer to determine if the specified waveform device’s interrupt number and DMA channel number are set correctly.

Parameters

pDO

Pointer to the waveform device’s device object. To obtain a device object, call SoundCreateDevice.

Return Value

Returns one of the following values.

Value	Definition
0	Operation succeeded.
1	Interrupt number is invalid.
2	DMA channel number is invalid.

Comments

Use the SoundTestWaveDevice function only if no other means for establishing interrupt and DMA channel numbers are available.

This function only works for devices that perform auto-initialize DMA transfers.

Drivers calling SoundTestWaveDevice must include wave.h.