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 または次の値を指定できます。
値 | 意味 |
---|---|
|
ストリームおよびファイル レイアウト エントリの単一インスタンスが返されます。 設定すると、ストリームごとに 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 を含む) |