FSRTL_PER_STREAM_CONTEXT 構造体 (ntifs.h)

[アーティクル]
03/08/2023

FSRTL_PER_STREAM_CONTEXT構造体には、ファイルシステムフィルタードライバーがファイルストリームに関して保持するコンテキスト情報が含まれています。

構文

typedef struct _FSRTL_PER_STREAM_CONTEXT {
  LIST_ENTRY     Links;
  PVOID          OwnerId;
  PVOID          InstanceId;
  PFREE_FUNCTION FreeCallback;
} FSRTL_PER_STREAM_CONTEXT, *PFSRTL_PER_STREAM_CONTEXT;

メンバー

Links

同じファイルストリームに関連付けられているすべてのストリームごとのコンテキスト構造の一覧で、この構造体のリンク。 FsRtlInsertPerStreamContext は、ファイルストリームのすべてのストリームごとのコンテキスト構造の一覧にこのメンバーを挿入します。ファイルオブジェクトからリストの先頭へのポインターを取得するには、 FsRtlGetPerStreamContextPointer マクロを使用し、結果を PFSRTL_ADVANCED_FCB_HEADER ポインターにキャストします。リストポインターは、ファイルストリームの高度なファイル制御ブロック (FCB) ヘッダー構造の FilterContexts メンバーです。

OwnerId

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

InstanceId

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

このメンバーは省略可能であり、 NULL にすることができます。

FreeCallback

ストリームごとのコンテキスト構造を解放するコールバックルーチンへのポインター。このルーチンとそのパラメーターは、次のように定義されます。

VOID
(*PFREE_FUNCTION) (
     IN PVOID Buffer
     );

バッファー

解放する FSRTL_PER_STREAM_CONTEXT 構造体へのポインター。

注釈

ファイルシステムフィルタードライバーは、 FSRTL_PER_STREAM_CONTEXT 構造体を使用して、ファイルストリームのコンテキスト情報を維持できます。この構造体は、そのまま使用することも、ドライバー定義のストリームごとのコンテキスト構造に埋め込んだりすることもできます。

ファイルシステムは、ファイルストリームのストリームコンテキストオブジェクトを破棄するときに、 FsRtlTeardownPerStreamContexts を呼び出す必要があります。これにより、ファイルストリームに関連付けられているすべてのストリームごとのコンテキスト構造の FreeCallback ルーチンが呼び出されます。

メモFreeCallback ルーチンは、ファイルシステムに再帰的に呼び出したり、ファイルシステムリソースを取得したりすることはできません。また、このルーチンは、ファイルストリームのファイルオブジェクトが既に解放されていることを前提とする必要があります。

FSRTL_PER_STREAM_CONTEXT構造体は、ページプールまたは非ページプールから割り当てることができます。

FsRtlSupportsPerStreamContexts マクロは、ファイルシステムが特定のファイルストリームのストリームごとのコンテキストをサポートするかどうかを決定します。

BOOLEAN FsRtlSupportsPerStreamContexts(
  [in] PFILE_OBJECT FileObject
);

パラメーター

FileObject [in]

PFILE_OBJECT

ファイルストリームのファイルオブジェクトへのポインター。

戻り値

BOOLEAN

FsRtlSupportsPerStreamContexts マクロは、ファイルシステムがファイルストリームのストリームごとのコンテキストをサポートしている場合は TRUE を返し、それ以外の場合は FALSE を返します。

ファイルシステムフィルタードライバーは 、FsRtlSupportsPerStreamContexts を呼び出して、基になるファイルシステムが、特定のファイルオブジェクトによって表されるファイルストリームのストリームごとのコンテキストをサポートしているかどうかを判断します。ファイルシステムでは、一部の種類のファイルではストリームごとのコンテキストがサポートされますが、他の種類のファイルではサポートされないことに注意してください。たとえば、NTFS と FAT は現在、ページングファイルのストリームごとのコンテキストをサポートしていません。

詳細については、「レガシファイルシステムフィルタードライバーでの追跡 Per-Stream コンテキスト」を参照してください。