IRP ディスパッチルーチンの記述

[アーティクル]
04/03/2024

Note

最適な信頼性とパフォーマンスを実現するには、レガシファイルシステムフィルタードライバーではなく、フィルターマネージャーのサポートがあるファイルシステムミニフィルタードライバーを使用します。レガシドライバーをミニフィルタードライバーに移植するには、「レガシフィルタードライバーの移植ガイドライン」を参照してください。

ファイルシステムフィルタードライバーは、デバイスドライバーで使用されるものと似たディスパッチルーチンを使用します。 ディスパッチルーチン は、1 つ以上の種類の IRP を処理します。 (IRP の型は、その主要な関数コードによって決まります)。ドライバーの DriverEntry ルーチンは、ドライバーオブジェクトのディスパッチテーブルに格納することによって、ディスパッチルーチンのエントリポイントを登録します。 IRP がドライバーに送信されると、I/O サブシステムは、IRP の主要な関数コードに基づいて適切なディスパッチルーチンを呼び出します。

すべての IRP ディスパッチルーチンは、次のように定義されます。

NTSTATUS
(*PDRIVER_DISPATCH) (
    IN PDEVICE_OBJECT DeviceObject,
    IN PIRP Irp
    );

ファイルシステムフィルタードライバーディスパッチルーチンは、IRQL PASSIVE_LEVEL で呼び出されることが最も多く、I/O 要求を発生させたスレッドのコンテキストで呼び出されます。これは、一般的にユーザーモードのアプリケーションスレッドです。ただし、この規則にはいくつかの例外があります。たとえば、ページフォールトにより、IRQL APC_LEVEL で読み取りと書き込みのディスパッチルーチンが呼び出されます。これらの例外は、ディスパッチルーチン IRQL とスレッドコンテキストの表にまとめられています。残念ながら、フィルターチェーン内のドライバーが IRQL > PASSIVE_LEVELで IoCallDriver を呼び出すのを防ぐことは現在できません (たとえば、スピンロックや高速ミューテックスの解放に失敗するなど)。ただし、フィルターディスパッチルーチンでは、呼び出されたのと同じ IRQL で常に IoCallDriver を呼び出す必要があることを強くお勧めします。

ディスパッチルーチンは、カーネルモードドライバーアーキテクチャ設計ガイドの「ドライバーのページング可能にする」セクションで説明されている条件を満たしている場合にページング可能にすることができます。

ファイルシステムフィルタードライバーにコントロールデバイスオブジェクト (CDO) がある場合、ディスパッチルーチンは、IRP のターゲットデバイスオブジェクトがマウントされたボリュームのボリュームデバイスオブジェクト (VDO) ではなく CDO である場合を検出して処理できる必要があります。 CDO の詳細については「フィルタードライバーのコントロールデバイスオブジェクト」を参照してください。

このセクションでは、次のトピックについて説明します。

IRP の完了

IRP を下位レベルのドライバーに渡す

ディスパッチルーチンから返される状態

例: 完了ルーチンを設定せずに IRP を渡す

ディスパッチルーチンに関する制約

ディスパッチルーチン IRQL とスレッドコンテキスト