次の方法で共有


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 値を返します。 ドライバーは、WdfDeviceWdmDispatchIrp を呼び出した EvtDeviceWdmIrpDispatch コールバック関数の戻り値としてこの戻り値使用する必要があります。

KMDF ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。 UMDF ドライバーが無効なハンドルを提供すると、ドライバー ホスト プロセスが終了します。

注釈

ドライバーが EvtDeviceWdmIrpDispatch コールバック関数を提供する場合は、コールバック関数内から WdfDeviceWdmDispatchIrp を呼び出して、特定のキューにディスパッチするのではなく、既定の処理のために IRP をフレームワークに返すことができます。

IRP の受信時のキューの指定の詳細については、「I/O キューへの IRP のディスパッチ」を参照してください。

必要条件

要件 価値
ターゲット プラットフォーム 普遍
最小 KMDF バージョン 1.11
UMDF の最小バージョン する 2.17
ヘッダー wdfdevice.h (Wdf.h を含む)
図書館 Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 する DriverCreate(kmdf)

こちらもご覧ください

EvtDeviceWdmIrpDispatch

WdfDeviceWdmDispatchIrpToIoQueue