共用方式為

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 佇列。

規格需求

需求 值
目標平台 Universal
最低 KMDF 版本 1.11
最低UMDF版本 2.17
標頭 wdfdevice.h (包含 Wdf.h)
程式庫 Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 DriverCreate (kmdf)

另請參閱

EvtDeviceWdmIrpDispatch

WdfDeviceWdmDispatchIrpToIoQueue