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.