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 |