WdfDeviceWdmDispatchPreprocessedIrp function

[Applies to KMDF only]

The WdfDeviceWdmDispatchPreprocessedIrp method returns a preprocessed IRP to the framework.

Syntax

NTSTATUS WdfDeviceWdmDispatchPreprocessedIrp(
  WDFDEVICE Device,
  PIRP      Irp
);

Parameters

Device

A handle to a framework device object.

Irp

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

   
Target Platform Universal
Minimum KMDF version 1.0
Header wdfdevice.h (include Wdf.h)
Library Wdf01000.sys (see Framework Library Versioning.)
IRQL "<= DISPATCH_LEVEL"
DDI compliance rules DriverCreate, KmdfIrql, KmdfIrql2