FILE_REGION_INPUT 结构 (ntifs.h)
FILE_REGION_INPUT 是 FSCTL_QUERY_FILE_REGIONS的可选输入结构。
语法
typedef struct _FILE_REGION_INPUT {
LONGLONG FileOffset;
LONGLONG Length;
ULONG DesiredUsage;
} FILE_REGION_INPUT, *PFILE_REGION_INPUT;
成员
FileOffset
一个 64 位有符号整数，包含文件中字节范围开头的文件偏移量（以字节为单位）。
Length
包含范围的大小（以字节为单位）的 64 位有符号整数。
DesiredUsage
一个 32 位无符号整数，指示此操作的使用参数。 DesiredUsage 可以是以下值之一。
| 值 | 含义 |
|---|---|
| FILE_REGION_USAGE_VALID_CACHED_DATA (0x00000001) | 请求返回有关有效数据长度的信息 (缓存中指定文件和文件范围的 VDL) 。 |
| FILE_REGION_USAGE_VALID_NONCACHED_DATA (0x00000002) | 请求返回有关磁盘上指定文件和文件范围的 VDL 的信息。 |
| 所有其他值 | 如果在 FSCTL_QUERY_FILE_REGION 中指定了 FILE_REGION_INPUT对象，则任何其他值都将返回STATUS_INVALID_PARAMETER。 |
注解
有关详细信息 ，请参阅FSCTL_QUERY_FILE_REGIONS 。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8 |
| 标头 | ntifs.h |