WdfDeviceWdmDispatchIrp 函式 (wdfdevice.h)

[適用於 KMDF 和 UMDF]

WdfDeviceWdmDispatchIrp 方法會從 EvtDeviceWdmIrpDispatch 將分派的 IRP 傳回至架構。

語法

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

[in] Device

架構裝置物件的句柄。

[in] Irp

IRP 結構的指標。

[in] DispatchContext

驅動程式在 EvtDeviceWdmIrpDispatch 回呼中收到的分派內容參數。

WdfDeviceWdmDispatchIrp 方法會傳回 NTSTATUS 值，此值是由架構或驅動程式在處理 IRP 時提供。驅動程式必須使用這個傳回值作為呼叫 WdfDeviceWdmDispatchIrp 之 EvtDeviceWdmIrpDispatch 回呼函式的傳回值。

如果 KMDF 驅動程式提供無效的物件句柄，就會發生錯誤檢查。如果 UMDF 驅動程式提供無效的句柄，驅動程式主機進程就會終止。

如果您的驅動程式提供 EvtDeviceWdmIrpDispatch 回呼函式，您可以從回調函式內呼叫 WdfDeviceWdmDispatchIrp ，以將 IRP 傳回至架構以進行默認處理，而不是將它分派至特定佇列。

如需在 IRP 抵達時指定佇列的詳細資訊，請參閱將 IRP 分派給 I/O 佇列。