FsRtlSetupAdvancedHeaderEx2 マクロ (ntifs.h)

[アーティクル]
02/26/2024

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

構文

void FsRtlSetupAdvancedHeaderEx2(
   _advhdr,
   _fmutx,
   _fctxptr,
   _aepushlock
);

パラメーター

_advhdr

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

_fmutx

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

_fctxptr

ファイルシステムランタイムライブラリ (FSRTL) がファイルコンテキストを追跡するために使用するポインターフィールドへのポインター。このパラメーターは省略可能であり、 NULL にすることができます。 FileContextSupportPointer が NULL でない場合、FileContextSupportPointer は、構造を作成したファイルシステムのファイルごとの構造内の PVOID 変数へのポインターである必要があります。ファイルシステムドライバーがファイルコンテキストをサポートしていないことを示すには、呼び出し元が FileContextSupportPointer を NULL に設定する必要があります。

_aepushlock

高度なヘッダーの AePushLock フィールドを初期化するために使用される不透明な構造体へのポインター。この関数の呼び出し元は、最初に FsRtlAllocateAePushLock を呼び出してこのフィールドのメモリを割り当て、初期化し、その後 FsRtlFreeAePushLock を呼び出してメモリを解放します。自動拡張プッシュロックの詳細については、「 FSRTL_ADVANCED_FCB_HEADER 」を参照してください。