SoundInitializeWaveInfo

VOID
    SoundInitializeWaveInfo(
        PWAVE_INFO WaveInfo,
        UCHAR DMAType,
        PSOUND_QUERY_FORMAT_ROUTINE QueryFormat,
        PVOID HwContext
        );

The SoundInitializeWaveInfo initializes a WAVE_INFO structure.

Parameters

WaveInfo

Pointer to a WAVE_INFO structure.

DMAType

Type of DMA to use. One of the following enumerated values:

enum {
    SoundNoDMA,
    SoundAutoInitDMA,             // Use auto-initialize
    SoundReprogramOnInterruptDMA, // Reprogram on interrupt
    Sound2ChannelDMA              // Keep 2 channels going
};

Sound2ChannelDMA is not currently supported in soundlib.lib.

QueryFormat

Pointer to a function of type SOUND_QUERY_FORMAT_ROUTINE.

HwContext

Pointer to a driver-defined structure containing hardware context information. Pointer is stored in the HwContext member of WAVE_INFO.

Return Value

None.

Comments

Before calling SoundInitializeWaveInfo, the driver must initialize the HwSetupDMA, HwStopDMA, and HwSetWaveFormat structure members and zero the rest of the structure.

Drivers calling SoundInitializeWaveInfo must include wave.h.