FSRTL_PER_FILEOBJECT_CONTEXT 構造体 (ntifs.h)

[アーティクル]
02/26/2024

OS は、不透明な FSRTL_PER_FILEOBJECT_CONTEXT 構造を使用して、ファイルオブジェクトのファイルシステムフィルタードライバー定義コンテキスト情報構造を追跡します。

構文

typedef struct _FSRTL_PER_FILEOBJECT_CONTEXT {
  LIST_ENTRY Links;
  PVOID      OwnerId;
  PVOID      InstanceId;
} FSRTL_PER_FILEOBJECT_CONTEXT, *PFSRTL_PER_FILEOBJECT_CONTEXT;

メンバー

Links

同じファイルオブジェクトに関連付けられているすべてのファイルオブジェクトごとのコンテキスト構造の一覧で、この構造体のリンク。 FsRtlInsertPerFileObjectContext は、ファイルオブジェクトのすべてのファイルオブジェクトごとのコンテキスト構造の一覧にこのメンバーを挿入します。

OwnerId

ファイルオブジェクトごとのコンテキスト構造の所有フィルターを一意に識別する、フィルタードライバーによって割り当てられた変数へのポインター。この変数の形式は、フィルタードライバー固有です。フィルターライターは、フィルターのデバイスオブジェクトやドライバーオブジェクトのアドレスなど、意味のある便利な値を選択する必要があります。このメンバーの値を NULL にすることはできません。

InstanceId

同じフィルタードライバーによって作成されたファイルオブジェクトごとのコンテキスト構造を区別するために使用できる、フィルタードライバーによって割り当てられた変数へのポインター。この変数の形式は、フィルタードライバー固有です。フィルターライターは、ファイルオブジェクト自体のアドレスなど、意味のある便利な値を選択する必要があります。このメンバーの値には NULL を指定できます。

注釈

ファイルシステムフィルタードライバーは、不透明な FSRTL_PER_FILEOBJECT_CONTEXT 構造を使用して、ファイルオブジェクトのコンテキスト情報を維持できます。この構造体は、そのまま使用することも、ドライバー定義のファイル単位のオブジェクトごとのコンテキスト構造に埋め込んだりすることもできます。

各ファイルオブジェクトには、ファイルオブジェクトごとのコンテキスト構造リストを 1 つ関連付けることができます。このリストの各メンバー (つまり、特定のファイルオブジェクトごとのコンテキスト構造) は、フィルタードライバーによって所有されます。フィルタードライバーの観点から見ると、各フィルタードライバーは、同じファイルオブジェクトに対して複数のファイルオブジェクトごとのコンテキスト構造を関連付けることができます。

各フィルター定義のファイルオブジェクトごとのコンテキスト構造には、初期化されたFSRTL_PER_FILEOBJECT_CONTEXT構造体を含める必要があります。 FSRTL_PER_FILEOBJECT_CONTEXT構造体は、ページプールまたは非ページプールから割り当てることができ、 FsRtlInitPerFileObjectContext マクロを使用して初期化する必要があります。

FSRTL_PER_FILEOBJECT_CONTEXT構造体またはフィルター定義のファイルオブジェクトごとのコンテキスト構造 (初期化されたFSRTL_PER_FILEOBJECT_CONTEXT構造体を含む) をファイルオブジェクトのすべてのコンテキスト構造の一覧に挿入するには、 FsRtlInsertPerFileObjectContext 関数を使用します。

FSRTL_PER_FILEOBJECT_CONTEXTまたはファイルオブジェクトごとのコンテキスト構造がファイルオブジェクトに関連付けられた後は、 FsRtlLookupPerFileObjectContext を呼び出して取得するか、 または FsRtlRemovePerFileObjectContext ( OwnerId と InstanceId の値に基づく) を呼び出して削除できます。

ファイルシステムミニフィルタードライバーでは、次の関数を使用しないでください。

代わりに、ミニフィルターは次の関数を使用して、コンテキスト情報をファイルオブジェクトに関連付けることができます。

ファイルシステムミニフィルタードライバーでは 、FsRtlXxxPerFileObjectContext 関数を使用しないでください。代わりに、ミニフィルターは FltXxxコンテキスト 関数を使用して、コンテキスト情報をファイルオブジェクトに関連付けることができます。完全な一覧については、 FSRTL_PER_FILEOBJECT_CONTEXT トピックを参照してください。