FSRTL_ADVANCED_FCB_HEADER構造体 (ntifs.h)

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

FSRTL_ADVANCED_FCB_HEADER 構造体には、ファイルシステムがファイルに関して保持するコンテキスト情報が含まれています。

構文

typedef struct _FSRTL_ADVANCED_FCB_HEADER {
  FSRTL_COMMON_FCB_HEADER          DUMMYSTRUCTNAME;
  PFAST_MUTEX                      FastMutex;
  LIST_ENTRY                       FilterContexts;
  EX_PUSH_LOCK                     PushLock;
  PVOID                            *FileContextSupportPointer;
  union {
    OPLOCK Oplock;
    PVOID  ReservedForRemote;
  };
  PVOID                            AePushLock;
  PVOID                            ReservedContextLegacy;
  ULONG                            BypassIoOpenCount;
  struct _FSRTL_PER_STREAM_CONTEXT *ReservedContext;
} FSRTL_ADVANCED_FCB_HEADER;

メンバーズ

DUMMYSTRUCTNAME

FSRTL_COMMON_FCB_HEADER型の構造体を含む名前のないメンバー。

FastMutex

DUMMYSTRUCTNAMEの次のメンバーへのアクセスを同期するために使用される、初期化された高速ミューテックスポインター。

AllocationSize
FileSize
ValidDataLength

存在する場合、PushLock メンバーは、FilterContexts メンバーへのアクセスを同期するために使用されます。それ以外の場合 FastMutex が使用されます。

FilterContexts

ファイルに関連付けられているすべてのコンテキスト構造のリストの先頭へのポインター。フィルタードライバーは、fsRtlLookupPerStreamContext 呼び出してこの一覧を検索し、FsRtlInsertPerStreamContext を呼び出して FsRtlRemovePerStreamContext変更できます。

PushLock

FilterContexts リストへのアクセスを同期するために使用されるプッシュロック。このフィールドは、Windows Vista 以降でのみ使用できます (つまり、FSRTL_COMMON_FCB_HEADER 構造体の Version ビットフィールドが FSRTL_FCB_HEADER_V1以上の場合)。

FileContextSupportPointer

ファイルコンテキストを追跡するためにファイルシステムランタイムライブラリ (FSRTL) によって使用されるポインターフィールドへのポインター。 NULLしない場合、このメンバーは、構造を作成したファイルシステムのファイルごとの構造内の PVOID 変数へのポインターである必要があります。 NULL場合、ファイルコンテキストはサポートされません。このメンバーは、Windows Vista 以降でのみ使用できます (つまり、FSRTL_COMMON_FCB_HEADER 構造体の Version ビットフィールドが FSRTL_FCB_HEADER_V1以上の場合)。

Oplock

ファイルまたはディレクトリの oplock。このフィールドは、Windows 8 以降でのみ使用できます (つまり、FSRTL_COMMON_FCB_HEADER 構造体の Version ビットフィールドが FSRTL_FCB_HEADER_V2以上の場合)。

ReservedForRemote

ファイルシステムがリモートの場合、このフィールドは予約されています。 Windows 8 以降でのみ使用できます (つまり、FSRTL_COMMON_FCB_HEADER 構造体の Version ビットフィールドが FSRTL_FCB_HEADER_V2以上の場合)。

AePushLock

ストリームコンテキストの一覧へのアクセスを同期するために PushLock 代わりに使用される自動展開プッシュロック。詳細については、「解説」を参照してください。

AePushlock は、Windows 10 バージョン 20H2 以降で使用できます (つまり、FSRTL_COMMON_FCB_HEADER 構造体の Version ビットフィールドが FSRTL_FCB_HEADER_V3以上の場合)、FsRtlSetupAdvancedHeaderEx2を呼び出して初期化する必要があります。

ReservedContextLegacy

このフィールドはシステム用に予約されています。 Windows 8.1 から Windows 10 バージョン 1803 でのみ使用されます (FSRTL_COMMON_FCB_HEADER 構造体の Version ビットフィールドが FSRTL_FCB_HEADER_V3以上の場合)。

BypassIoOpenCount

このストリームで BypassIO が有効になっている状態で現在開いているハンドルの数を追跡します。

このフィールドは、Windows 11 以降で使用できます (つまり、FSRTL_COMMON_FCB_HEADER 構造体の Version ビットフィールドが FSRTL_FCB_HEADER_V4以上の場合)。

ReservedContext

システム用に予約されています。

このフィールドは、Windows 11 バージョン 22H2 以降で使用できます (つまり、FSRTL_COMMON_FCB_HEADER 構造体の Version ビットフィールドが FSRTL_FCB_HEADER_V5以上の場合)。

備考

FSRTL_ADVANCED_FCB_HEADER 構造体は、FSRTL_COMMON_FCB_HEADER 構造体のスーパーセットです。ファイルシステム (レガシフィルターとミニフィルタードライバーを含む、該当する場合) は、FSRTL_ADVANCED_FCB_HEADER 構造体を使用する必要があります。

ファイルシステムでは、次のいずれかのマクロを使用して、FSRTL_ADVANCED_FCB_HEADER 構造体を初期化する必要があります。

FsRtlSetupAdvancedHeader の
FsRtlSetupAdvancedHeaderEx の
FsRtlSetupAdvancedHeaderEx2。Windows 10 バージョン 20H2 以降で使用できます。

これらのマクロでは、次のフラグが設定されます。

旗	意味
FSRTL_FLAG_ADVANCED_HEADER	FSRTL_COMMON_FCB_HEADER 構造体のメンバーフラグに設定され、このフラグは、FSRTL_ADVANCED_FCB_HEADER 構造体に対するファイルシステムドライバーのサポートを示します。このフラグは変更しないでください。
FSRTL_FLAG2_SUPPORTS_FILTER_CONTEXTS	FSRTL_COMMON_FCB_HEADERの Flags2 メンバーに設定され、このフラグはフィルタードライバーコンテキストのサポートを示します。このフラグは、ページングファイルに対してのみクリアできます (表の後の情報を参照してください)。

ファイルシステムでは、すべてのファイルオブジェクトの FsContext メンバーが FSRTL_ADVANCED_FCB_HEADER 構造体を指すように設定する必要があります。この構造体は、ファイルシステムストリームに固有のコンテキストオブジェクト構造の内部に埋め込むことができます (構造体の残りの部分はファイルシステム固有です)。通常、この構造体はファイル制御ブロック (FCB) です。ただし、NTFS などの複数のデータストリームをサポートする一部のファイルシステムでは、ストリーム制御ブロック (SCB) です。ボリュームオープン要求を含め、オープン要求のすべてのクラスの FCB および SCB には、この構造を含める必要があることに注意してください。

ファイルがページングファイルの場合は、FSRTL_ADVANCED_FCB_HEADER 構造体を非ページプールから割り当てる必要があります。それ以外の場合は、ページプールまたは非ページプールから割り当てることができます。

すべての Microsoft ファイルシステムは、fsRtlSetupAdvancedHeaderを呼び出した後、FSRTL_COMMON_FCB_HEADER の Flags2 メンバーの FSRTL_FLAG2_SUPPORTS_FILTER_CONTEXTS フラグをクリアすることで、ページングファイルのストリームコンテキストサポートを無効にします。 (FASTFAT WDK サンプルについては、Strucsup.c の FatCreateFcb 関数を参照してください)。オペレーティングシステムがすべてのファイルシステムで一貫した方法で動作するように、ファイルシステムまたはシステムで同じ操作を行うことを強くお勧めします。

プッシュロックの自動展開

自動拡張プッシュロックは、Windows 10 バージョン 20H2 で導入されました。フィルタマネージャのロックが当初設計されていた時、大規模なマルチプロセッサシステムは非常に珍しく、RAMは貴重でした。このようなシステムが一般的になり、RAMが制限されるようになったので、自動拡張プッシュロックはメモリ消費と速度の間に有益なトレードオフを提供します。

自動拡張プッシュロックは、多数の同時共有取得者が原因で高いキャッシュ競合が発生することが検出されると、通常のキャッシュ対応以外のプッシュロックからキャッシュ対応プッシュロックに自動的に変更される可能性があります。自動拡張プッシュロックは、展開されていない場合は通常のプッシュロックよりも大きくなりますが、キャッシュ対応のプッシュロックほど大きくはありません。このプッシュロックの種類は、マルチプロセッサシステムでよりパフォーマンスが高くなります。

必要条件

要件	価値
ヘッダー	ntifs.h (Ntifs.h、Fltkernel.h を含む)

次の方法で共有

FSRTL_ADVANCED_FCB_HEADER構造体 (ntifs.h)

構文

メンバーズ

備考

プッシュロックの自動展開

必要条件

関連項目

フィードバック

その他のリソース

次の方法で共有

FSRTL_ADVANCED_FCB_HEADER構造体 (ntifs.h)

構文

メンバーズ

備考

プッシュ ロックの自動展開

必要条件

関連項目

フィードバック

その他のリソース

プッシュロックの自動展開