FsRtlSetupAdvancedHeader 関数 (ntifs.h)

[アーティクル]
2024/12/21

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
ターゲットプラットフォームの	デスクトップ
ヘッダー	ntifs.h (Ntifs.h、Fltkernel.h を含む)
IRQL	<= APC_LEVEL

次の方法で共有

FsRtlSetupAdvancedHeader 関数 (ntifs.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース