次の方法で共有


FsRtlSetupAdvancedHeaderEx マクロ (ntifs.h)

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

関連項目

FSRTL_ADVANCED_FCB_HEADER

FSRTL_PER_STREAM_CONTEXT

FsRtlGetPerStreamContextPointer

FsRtlInitPerStreamContext

FsRtlInsertPerStreamContext

FsRtlLookupPerStreamContext

FsRtlRemovePerStreamContext

FsRtlSupportsPerStreamContexts

FsRtlTeardownPerStreamContexts