レガシ フィルター ドライバーの移植ガイドライン

開発者は、フィルター ドライバーの機能を向上させ、システムの信頼性を向上させるために、従来のフィルター ドライバーをフィルター マネージャー モデルに移植することをお勧めします。 経験豊富な開発者であれば、従来のフィルター ドライバーをミニフィルター ドライバーに移植するのは比較的簡単であることがわかります。 Microsoft のフィルター ドライバー開発者は、次のアプローチを推奨しています。

• 信頼性の高い回帰テスト スイートから始めて、従来のフィルター ドライバーと移植されたミニフィルター ドライバー間の動作を検証します。

• ミニフィルター ドライバー シェルを作成し、従来のフィルター ドライバーからミニフィルター ドライバーに機能を体系的に移動します。 たとえば、アタッチメントを動作させてから、一度に 1 つの操作を移植し、各操作の後にテストします。

• ユーザー モード/カーネル モード通信を最後に変更すると、既存のツールを使用してミニフィルター ドライバーをテストできます。

• PREfast でコンパイルし、Driver Verifier の Filter Verifier I/O 検証オプションを有効にしてテストします。

移植プロセス中に、フィルター マネージャーの機能を最大限に活用するために、すべての従来のフィルター ドライバー コードを確認する必要があります。 特に、次の点に留意してください。

• IRP ベースの I/O 操作と高速 I/O 操作は、必要に応じて同じ操作で実行できるため、コードの重複を減らすことができます。

• 操作を登録するときに、ミニフィルター ドライバーはすべてのページング I/O とキャッシュされた I/O を無視することを明示的に選択できるため、これらをチェックするコードの必要がなくなります。

• インスタンス通知により、アタッチ/デタッチ ロジックが大幅に簡素化されます。

• ミニフィルタードライバーが処理する必要がある操作にのみ登録します。他のすべてを無視できます。

• フィルター マネージャーのコンテキストと名前管理のサポートを活用します。

• 非再帰 I/O を発行するためのフィルター マネージャー サポートを利用します。

• 従来のフィルター ドライバーとは異なり、ミニフィルター ドライバーは、操作前処理から操作後処理までのコンテキストを維持するためにローカル変数に依存することができません。 操作状態を保存するためにルックアサイド リストを割り当てることを検討してください。

• 名前またはコンテキストの設定が完了したら、必ず参照を解放してください。

• ユーザー モードの完了ポートは、キューを構築するための強力な手法を追加します。 おそらく、単一の名前付きポートへの接続は 1 つだけ必要になります。

次の表は、従来のフィルター ドライバーでの一般的な操作と、それらがフィルター マネージャー モデルにどのようにマップされるかを示しています。