通过

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 成员中设置的标志确定，这些标志作为 FSCTL_QUERY_FILE_LAYOUT 请求的输入提供。 许多 FILE_LAYOUT_ENTRY 结构遵循 QUERY_FILE_LAYOUT_OUTPUT。 根据从查询返回的条目，FILE_LAYOUT_ENTRY 中的偏移量指示其他信息性条目位于用户缓冲区中的位置。

在 标志QUERY_FILE_LAYOUT_INPUT成员中设置相应的包含标志时，将返回以下条目结构。

进入 包含标志
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 （include Ntifs.h）

另请参阅

FSCTL_QUERY_FILE_LAYOUT

QUERY_FILE_LAYOUT_INPUT