FsRtlSetupAdvancedHeader 関数 (ntifs.h)

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

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

構文

void FsRtlSetupAdvancedHeader(
  PVOID       AdvHdr,
  PFAST_MUTEX FMutex
);

パラメーター

AdvHdr

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

FMutex

FSRTL_ADVANCED_FCB_HEADER構造体へのアクセスを同期するために使用される、初期化された高速ミューテックスへのポインター。高速ミューテックスは、非ページプールから割り当てる必要があります。

このパラメーターは、NULL でもかまいません。呼び出し元は、既存の高速ミューテックスオブジェクトを使用する場合、このパラメーターを NULL に 設定する必要があります。 FastMutex が NULL の場合、呼び出し元はストリームコンテキストオブジェクトの FastMutex メンバーを明示的に設定して、既存の高速ミューテックスを指す必要があります。 (これは、 FsRtlSetupAdvancedHeader を呼び出す前または後に行うことができます)。

戻り値

なし

解説

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

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

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

要件

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