FsRtlGetPerStreamContextPointer マクロ (ntifs.h)

[アーティクル]
03/05/2024

FsRtlGetPerStreamContextPointer マクロは、ファイルストリームのファイルシステムのストリームコンテキストを返します。

構文

void FsRtlGetPerStreamContextPointer(
   _fo
);

パラメーター

_fo

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

戻り値

なし

解説

ファイルシステムフィルタードライバーは 、FsRtlGetPerStreamContextPointer マクロを使用して、特定のファイルオブジェクトによって表されるファイルストリームのストリームコンテキストポインターを取得できます。ストリームコンテキストポインターは、ファイルストリームのファイルシステムのストリームコンテキストへのポインターです。このポインターは、 FsRtlInsertPerStreamContext、 FsRtlLookupPerStreamContext、および FsRtlRemovePerStreamContext にパラメーターとして渡すことができます。

ストリームコンテキストポインターは、ファイルシステムへのファイルストリームを一意に識別する FSRTL_ADVANCED_FCB_HEADER 構造体を指します。通常、この構造体は、ファイル制御ブロック (FCB) やストリーム制御ブロック (SCB) などのストリームコンテキストオブジェクトに埋め込まれます。ファイルストリームが開かれると、ファイルシステムは FCB または SCB へのポインターをファイルオブジェクトの FsContext メンバーに格納します。

メモFsRtlGetPerStreamContextPointer マクロは、高度な FCB ヘッダーをサポートするファイルシステムでのみ使用できます。

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

要件

要件	値
サポートされている最小のクライアント	Windows XP;Windows 2000 SP4 更新プログラムのロールアップ
対象プラットフォーム	デスクトップ
Header	ntifs.h (Ntifs.h を含む)
IRQL	<= APC_LEVEL