Expand Minimize

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

Wdfdevice.h (include Wdf.h)

Library

Wdf01000.sys (see Framework Library Versioning.)

IRQL

<= DISPATCH_LEVEL

DDI compliance rules

DriverCreate, KmdfIrql, KmdfIrql2

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft