WdfDeviceWdmDispatchPreprocessedIrp method
[Applies to KMDF only]
The WdfDeviceWdmDispatchPreprocessedIrp method returns a preprocessed IRP to the framework.
Syntax
NTSTATUS WdfDeviceWdmDispatchPreprocessedIrp( [in] WDFDEVICE Device, [in] PIRP Irp );
Parameters
- Device [in]
-
A handle to a framework device object.
- Irp [in]
-
A pointer to an IRP structure.
Return value
WdfDeviceWdmDispatchPreprocessedIrp returns an NTSTATUS value that that framework or the driver provides as the result of processing the IRP. The driver must use this return value as the return value for the EvtDeviceWdmIrpPreprocess callback function.
A bug check occurs if the driver supplies an invalid object handle.
Remarks
A framework-based driver that preprocesses or postprocesses WDM IRPs must call WdfDeviceWdmDispatchPreprocessedIrp, typically from within the driver's EvtDeviceWdmIrpPreprocess callback function. For more information about how to call WdfDeviceWdmDispatchPreprocessedIrp, see Preprocessing and Postprocessing IRPs.
Examples
For a code example that uses WdfDeviceWdmDispatchPreprocessedIrp, see Preprocessing and Postprocessing IRPs.
Requirements
|
Minimum KMDF version | 1.0 |
|---|---|
|
Header |
|
|
Library |
|
|
IRQL | <= DISPATCH_LEVEL |
|
DDI compliance rules | DriverCreate, KmdfIrql, KmdfIrql2 |
