ntifs.h) (FILE_REGION_INFO 结构

项目
08/07/2023

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 位无符号整数，指示文件的给定区域的用法。 Usage 可以是以下值之一。

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