WdfDeviceWdmDispatchPreprocessedIrp function (wdfdevice.h)

[Applies to KMDF only]

The WdfDeviceWdmDispatchPreprocessedIrp method returns a preprocessed IRP to the framework.

Syntax

NTSTATUS WdfDeviceWdmDispatchPreprocessedIrp(
  [in] WDFDEVICE Device,
  [in] PIRP      Irp
);

Parameters

[in] Device

A handle to a framework device object.

[in] Irp

A pointer to an IRP structure.

Return value

WdfDeviceWdmDispatchPreprocessedIrp returns an NTSTATUS value that the 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

Requirement Value
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(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)