ファイルシステムフィルタードライバーの初期化

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

Note

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

その DriverEntry 従来のファイルシステムフィルタードライバーを初期化するルーチンは次のようなものです。DriverEntry デバイスドライバーを初期化するルーチン。ドライバーがロードされた後、ドライバーをロードした同じコンポーネントも、ドライバーの DriverEntry ルーティーン。ファイルシステムフィルタードライバーの場合、ドライバーをロードするコンポーネントは、I/O マネージャー (開始タイプが SERVICE_BOOT_START であるフィルターの場合) またはサービスコントロールマネージャー (他の開始タイプの場合) です。

その DriverEntry ルーチンは、IRQL = PASSIVE_LEVEL のシステムスレッドコンテキストで実行されます。このルーチンはページング可能であり、破棄されるように INIT セグメント内に存在する必要があります。ドライバーコードをページング可能にする方法の詳細については、「」の「備考」セクションを参照してください。MmLockPagableCodeSection.

その DriverEntry ルーチンは次のように定義されます。

NTSTATUS 
(*PDRIVER_INITIALIZE) ( 
    IN PDRIVER_OBJECT DriverObject, 
    IN PUNICODE_STRING RegistryPath 
    );

このルーチンには 2 つの入力パラメータがあります。最初、DriverObject、ファイルシステムフィルタードライバーが読み込まれたときに作成されたドライバーオブジェクトです。 2番目、RegistryPath、ドライバーのレジストリキーへのパスを含む、カウントされた Unicode 文字列へのポインターです。

その DriverEntry ファイルシステムフィルタードライバーのルーチンは、次の手順を実行します。

コントロールデバイスオブジェクトの作成

IRPディスパッチルーチンの登録

高速 I/O ディスパッチルーチンの登録

FsFilter コールバックルーチンの登録

その他必要な初期化の実行

[オプション] コールバックルーチンの登録

[オプション] レジストリパス文字列のコピーの保存

返される状態