通过

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 输入上， Length 必须大于或等于 0。 在 FSCTL 输出中， 长度 必须大于 0。

要求

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

另请参阅

FSCTL_QUERY_ALLOCATED_RANGES