FILE_REGION_INFO结构(ntifs.h)

FILE_REGION_INFO 结构包含基于所需使用情况的文件的计算区域。 此结构用于存储 FSCTL_QUERY_FILE_REGIONS 答复消息的区域信息,FILE_REGION_OUTPUT 结构包含一个或多个 FILE_REGION_INFO 结构。

语法

typedef struct _FILE_REGION_INFO {
  LONGLONG FileOffset;
  LONGLONG Length;
  ULONG    Usage;
  ULONG    Reserved;
} FILE_REGION_INFO, *PFILE_REGION_INFO;

成员

FileOffset

包含区域的文件偏移量(以字节为单位)的 64 位有符号整数。

Length

一个包含区域大小(以字节为单位)的 64 位带符号整数。

Usage

一个 32 位无符号整数,指示文件的给定区域的用法。 使用情况 可以是以下值之一。

价值 意义
0x00000000 给定范围无效。 它与所请求 DesiredUsage的条件不匹配。
FILE_USAGE_VALID_CACHED_DATA(0x00000001) 定义 VDL 之前存在的文件的这些区域,因为它存在于缓存管理器中。
FILE_USAGE_VALID_NONCACHED_DATA(0x00000002) 定义在存储设备上的 VDL 之前存在的文件的这些区域。

Reserved

保留;此字段应设置为零并忽略。

要求

要求 价值
最低支持的客户端 Windows 8
标头 ntifs.h

另请参阅

FILE_REGION_INPUT

FILE_REGION_OUTPUT

FSCTL_QUERY_FILE_REGIONS