WdfDeviceWdmDispatchPreprocessedIrp 函式 （wdfdevice.h）

[僅適用於 KMDF]

WdfDeviceWdmDispatchPreprocessedIrp 方法會將前置處理的 IRP 傳回架構。

語法

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

參數

[in] Device

架構裝置物件的句柄。

[in] Irp

IRP 結構的指標。

返回值

WdfDeviceWdmDispatchPreprocessedIrp 會傳回架構或驅動程式在處理 IRP 時所提供的 NTSTATUS 值。 驅動程式必須使用這個傳回值作為 EvtDeviceWdmIrpPreprocess 回呼函式的傳回值。

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

備註

預先處理或後處理 WDM IRP 的架構型驅動程式必須呼叫 WdfDeviceWdmDispatchPreprocessedIrp，通常是從驅動程式的 EvtDeviceWdmIrpPreprocess 函式 回呼函式。 如需如何呼叫 WdfDeviceWdmDispatchPreprocessedIrp的詳細資訊，請參閱 前置處理和後處理 IRP。

範例

如需使用 WdfDeviceWdmDispatchPreprocessedIrp的程式碼範例，請參閱 前置處理和後處理 IRP。

需求

要求	價值
目標平臺	普遍
最低 KMDF 版本	1.0
標題	wdfdevice.h （包括 Wdf.h）
程式庫	Wdf01000.sys （請參閱架構連結庫版本控制。）
IRQL	<= DISPATCH_LEVEL
DDI 合規性規則	DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf）