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	返回流和文件布局条目的单个实例。 设置后，每个流仅返回一个 STREAM_LAYOUT_ENTRY 结构，每个文件仅返回一个 FILE_LAYOUT_ENTRY 结构。 此标志始终设置为 NTFS。

Reserved

保留。

注解

遵循QUERY_FILE_LAYOUT_OUTPUT结构的文件布局条目由QUERY_FILE_LAYOUT_INPUT的 Flags 成员中设置的标志确定，这些标志作为FSCTL_QUERY_FILE_LAYOUT请求的输入提供。 许多 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

 

当单个 FILE_LAYOUT_ENTRY 结构存在同一类型的多个条目时，每个信息性条目结构都有一个偏移成员，用于指示下一个条目的位置。 入口结构链一直持续到偏移成员的值为 0。

要求

要求	值
最低受支持的客户端	从 Windows 8 开始可用。
标头	ntifs.h (包括 Ntifs.h)

另请参阅

FSCTL_QUERY_FILE_LAYOUT

QUERY_FILE_LAYOUT_INPUT