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: