FsRtlSetupAdvancedHeaderEx マクロ (ntifs.h)

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

FsRtlSetupAdvancedHeaderEx マクロは、ストリームコンテキストとファイルコンテキストの両方で使用するFSRTL_ADVANCED_FCB_HEADER構造体を初期化するためにファイルシステムによって使用されます。

構文

void FsRtlSetupAdvancedHeaderEx(
   _advhdr,
   _fmutx,
   _fctxptr
);

パラメーター

_advhdr

初期化する FSRTL_ADVANCED_FCB_HEADER 構造体へのポインター。

_fmutx

特定の FSRTL_ADVANCED_FCB_HEADER メンバーへのアクセスを同期するために使用される、初期化された高速ミューテックスへのポインター。高速ミューテックスは、非ページプールから割り当てる必要があります。このパラメーターは省略可能であり、 NULL にすることができます。呼び出し元は、既存の高速ミューテックスオブジェクトを使用する場合は、このパラメーターを NULL に 設定する必要があります。 FastMutex が NULL の場合、呼び出し元は、ストリームコンテキストオブジェクトに含まれるFSRTL_ADVANCED_FCB_HEADER構造体の FastMutex メンバーを明示的に設定して、既存の高速ミューテックスを指す必要があります。 (これは、 FsRtlSetupAdvancedHeaderEx を呼び出す前または後に行うことができます)。

_fctxptr

ファイルシステムランタイムライブラリ (FSRTL) がファイルコンテキストを追跡するために使用するポインターフィールドへのポインター。このパラメーターは省略可能であり、 NULL にすることができます。特に次の点に違いがあります。

Windows Vista より前にリリースされた Microsoft Windows オペレーティングシステムの場合、呼び出し元はこのパラメーターを NULL に設定する必要があります。
Windows Vista 以降の Windows オペレーティングシステムの場合: FileContextSupportPointer が NULL でない場合、 FileContextSupportPointer は、構造を作成したファイルシステムのファイルごとの構造内の PVOID 変数へのポインターである必要があります。ファイルシステムドライバーがファイルコンテキストをサポートしていないことを示すには、呼び出し元が FileContextSupportPointer を NULL に設定する必要があります。

戻り値

なし

解説

ファイルシステムでは 、FsRtlSetupAdvancedHeaderEx マクロを使用して、ストリームおよびファイルコンテキストで使用するFSRTL_ADVANCED_FCB_HEADER構造体を初期化します。

高度な FCB ヘッダー構造が不要になった場合、ファイルシステムは FsRtlTeardownPerStreamContexts を呼び出して、関連付けられているすべてのストリームおよびファイルコンテキスト構造を解放する必要があります。

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

要件

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