FSRTL_PER_FILEOBJECT_CONTEXT構造体 (ntifs.h)

[アーティクル]
12/22/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 構造体を使用して、ファイルオブジェクトのコンテキスト情報を維持できます。この構造体は、as-is 使用することも、ドライバー定義のファイルごとのオブジェクトごとのコンテキスト構造に埋め込んだりすることもできます。

各ファイルオブジェクトには、ファイルオブジェクトごとのコンテキスト構造リストを 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の値に基づきます)。

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

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

FltAllocateContext の
FltDeleteContext の
FltSetStreamHandleContext の
FltDeleteStreamHandleContext の
FltGetStreamHandleContext の
FltReleaseContext の

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

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista
ヘッダー	ntifs.h (Fltkernel.h、Ntifs.h を含む)

次の方法で共有

FSRTL_PER_FILEOBJECT_CONTEXT構造体 (ntifs.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース