Expand Minimize

WdfDeviceWdmDispatchIrp method

[Applies to KMDF only]

The WdfDeviceWdmDispatchIrp method returns a dispatched IRP to the framework from EvtDeviceWdmIrpDispatch.

Syntax


NTSTATUS WdfDeviceWdmDispatchIrp(
  [in] WDFDEVICE   Device,
  [in] PIRP          Irp,
  [in] WDFCONTEXT   DispatchContext
);

Parameters

Device [in]

A handle to a framework device object.

Irp [in]

A pointer to an IRP structure.

DispatchContext [in]

The dispatch context parameter the driver received in EvtDeviceWdmIrpDispatch callback.

Return value

The WdfDeviceWdmDispatchIrp method returns an NTSTATUS value that the framework or the driver provides as a result of processing the IRP. The driver must use this return value as the return value for the EvtDeviceWdmIrpDispatch callback function that called WdfDeviceWdmDispatchIrp.

A bug check occurs if the driver supplies an invalid object handle.

Remarks

If your driver provides an EvtDeviceWdmIrpDispatch callback function, you can call WdfDeviceWdmDispatchIrp from within the callback function to return the IRP to the framework for default processing instead of dispatching it to a specific queue.

For more information about specifying queues for IRPs as they arrive, see Dispatching IRPs to I/O Queues.

Requirements

Target platform

Universal

Minimum KMDF version

1.11

Header

Wdfdevice.h (include Wdf.h)

Library

Wdf01000.sys (see Framework Library Versioning.)

IRQL

<= DISPATCH_LEVEL

DDI compliance rules

DriverCreate

See also

EvtDeviceWdmIrpDispatch
WdfDeviceWdmDispatchIrpToIoQueue

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft