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 方法會傳回架構或驅動程式因處理 IRP 而提供的 NTSTATUS 值。 驅動程式必須使用這個傳回值做為 EvtDeviceWdmIrpDispatch 回呼函式的傳回值,WdfDeviceWdmDispatchIrp。
如果 KMDF 驅動程式提供無效的物件句柄,就會發生錯誤檢查。 如果 UMDF 驅動程式提供無效的句柄,驅動程式主機進程就會終止。
備註
如果您的驅動程式提供 EvtDeviceWdmIrpDispatch 回呼函式,您可以從回調函式中呼叫 WdfDeviceWdmDispatchIrp,將 IRP 傳回至架構以進行默認處理,而不是將它分派至特定佇列。
如需在 IRP 到達時指定佇列的詳細資訊,請參閱 將 IRP 分派至 I/O 佇列。
需求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
最低 KMDF 版本 | 1.11 |
最低 UMDF 版本 | 2.17 |
標題 | wdfdevice.h (包括 Wdf.h) |
程式庫 | Wdf01000.sys (KMDF):WUDFx02000.dll (UMDF) |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | DriverCreate(kmdf) |