FILE_ALLOCATED_RANGE_BUFFER结构（ntifs.h）

FILE_ALLOCATED_RANGE_BUFFER 结构在 FSCTL_QUERY_ALLOCATED_RANGES 控制代码请求期间用作输入和输出。

语法

typedef struct _FILE_ALLOCATED_RANGE_BUFFER {
  LARGE_INTEGER FileOffset;
  LARGE_INTEGER Length;
} FILE_ALLOCATED_RANGE_BUFFER, *PFILE_ALLOCATED_RANGE_BUFFER;

成员

FileOffset

在 FSCTL 输入中，包含文件起始字节范围的文件偏移量（以字节为单位）。 FileOffset 必须大于或等于 0。

在 FSCTL 输出中，包含文件起始位置的文件偏移量（以字节为单位）;存储分配到的字节范围的开始。 如果文件是稀疏文件，FileOffset 可以包含未为其分配存储的字节范围;这些范围将从 FSCTL_QUERY_ALLOCATED_RANGES返回的已分配范围列表中排除。 由于使用稀疏文件的应用程序可以选择是否为每个0x00值字节序列分配磁盘空间，因此分配的范围可以包含0x00值字节。 此值在输出时必须大于或等于 0。

Length

包含范围的大小（以字节为单位）。 在 FSCTL 输入上，长度 必须大于或等于 0。 在 FSCTL 输出中，长度 必须大于 0。

要求

另请参阅

FSCTL_QUERY_ALLOCATED_RANGES