QUERY_FILE_LAYOUT_OUTPUT 構造体 (ntifs.h)

  • [アーティクル]

QUERY_FILE_LAYOUT_OUTPUT構造体は、FSCTL_QUERY_FILE_LAYOUT要求から返されるファイル レイアウト エントリのヘッダーとして機能します。

構文

typedef struct _QUERY_FILE_LAYOUT_OUTPUT {
  ULONG FileEntryCount;
  ULONG FirstFileOffset;
  ULONG Flags;
  ULONG Reserved;
} QUERY_FILE_LAYOUT_OUTPUT, *PQUERY_FILE_LAYOUT_OUTPUT;

メンバー

FileEntryCount

この構造体に続くファイル エントリの数。

FirstFileOffset

最初のファイル エントリのユーザー バッファー内のオフセット。

Flags

返されるレイアウト エントリの形式を示します。 0 または次の値を指定できます。

値 意味
QUERY_FILE_LAYOUT_SINGLE_INSTANCED
 ストリームおよびファイル レイアウト エントリの単一インスタンスが返されます。 設定すると、ストリームごとに 1 つの STREAM_LAYOUT_ENTRY 構造体のみが返され、ファイルごとに 1 つの FILE_LAYOUT_ENTRY 構造体のみが返されます。 このフラグは常に NTFS に設定されます。

Reserved

予約済み。

注釈

QUERY_FILE_LAYOUT_OUTPUT構造に従うファイル レイアウト エントリは、FSCTL_QUERY_FILE_LAYOUT要求への入力として提供される QUERY_FILE_LAYOUT_INPUT の Flags メンバーに設定されたフラグによって決まります。 多くの FILE_LAYOUT_ENTRY 構造体が QUERY_FILE_LAYOUT_OUTPUTに続きます。 クエリから返すように選択されたエントリに応じて、 FILE_LAYOUT_ENTRY のオフセットは、追加の情報エントリがユーザー バッファー内のどこにあるかを示します。

次のエントリ構造体は、対応する包含フラグが QUERY_FILE_LAYOUT_INPUT の Flags メンバーに設定されている場合に返されます。

入力 包含フラグ
FILE_LAYOUT_NAME_ENTRY QUERY_FILE_LAYOUT_INCLUDE_NAMES
FILE_LAYOUT_INFO_ENTRY QUERY_FILE_LAYOUT_INCLUDE_EXTRA_INFO
STREAM_LAYOUT_ENTRY QUERY_FILE_LAYOUT_INCLUDE_STREAMS
STREAM_EXTENT_ENTRY QUERY_FILE_LAYOUT_INCLUDE_EXTENTS
 

1 つの FILE_LAYOUT_ENTRY 構造体に同じ型の複数のエントリが存在する場合、各情報エントリ構造には、次のエントリの場所を示すオフセット メンバーがあります。 エントリ構造体のチェーンは、オフセット メンバーの値が 0 になるまで続行されます。

要件

要件 値
サポートされている最小のクライアント Windows 8 以降で使用できます。
Header ntifs.h (Ntifs.h を含む)

こちらもご覧ください

FSCTL_QUERY_FILE_LAYOUT

QUERY_FILE_LAYOUT_INPUT