SoundDispatch

NTSTATUS
    SoundDispatch(
        IN PDEVICE_OBJECT pDO,
        IN PIRP pIrp
);

The SoundDispatch function is the main dispatcher for IRP function codes within soundlib.lib

Parameters

pDO

Pointer to a device object.

pIrp

Pointer to an IRP.

Return Value

Returns STATUS_SUCCESS if the operation succeeds. Otherwise returns an NTSTATUS error code.

Comments

For more information about device objects and IRPs, see the Kernel-Mode Drivers Design Guide.

Within the DEVICE_OBJECT structure passed to a kernel-mode driver’s DriverEntry function, SoundDispatch must be specified as the dispatcher for the following IRP control codes:

• IRP_MJ_CLEANUP

• IRP_MJ_CLOSE

• IRP_MJ_CREATE

• IRP_MJ_DEVICE_CONTROL

• IRP_MJ_READ

• IRP_MJ_WRITE

SoundDispatch does not process the IRPs. Instead, it calls the secondary dispatcher specified as the DispatchRoutine member of the appropriate SOUND_DEVICE_INIT structure. (A pointer to the SOUND_DEVICE_INIT structure is contained in the device object.) Secondary dispatchers provided by soundlib.lib are:

• SoundAuxDispatch 

• SoundMidiDispatch 

• SoundMixerDispatch 

• SoundWaveDispatch