RETRIEVAL_POINTERS_BUFFER 结构 (winioctl.h)

包含 FSCTL_GET_RETRIEVAL_POINTERS 控制代码的输出。

语法

typedef struct RETRIEVAL_POINTERS_BUFFER {
  DWORD                    ExtentCount;
  LARGE_INTEGER            StartingVcn;
  struct {
    LARGE_INTEGER NextVcn;
    LARGE_INTEGER Lcn;
  };
  __unnamed_struct_1933_64 Extents[1];
} RETRIEVAL_POINTERS_BUFFER, *PRETRIEVAL_POINTERS_BUFFER;

成员

ExtentCount

Extents 数组中的元素计数。

StartingVcn

函数调用返回的起始 VCN。 这不一定是函数调用请求的 VCN,因为文件系统驱动程序可能会向下舍入到找到所请求的起始 VCN 的范围的第一个 VCN。

NextVcn

Lcn

Extents[1]

盘区结构的数组。 有关数组中成员的数目,请参阅 ExtentCount。 数组的每个成员都具有以下成员。

NextVcn

下一个盘区开始的 VCN。 此值减去第一个 Extents 数组成员的 StartingVcn () 或数组上一个成员的 NextVcn, (所有其他 Extents 数组成员) 是当前盘区的长度(以群集为单位)。 长度是 FSCTL_MOVE_FILE 操作的输入。

Lcn

当前盘区从卷上开始的 LCN。 此值是 FSCTL_MOVE_FILE 操作的输入。 在 NTFS 文件系统上,LONGLONG) –1 (值指示部分分配的压缩单元或稀疏文件的未分配区域。

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 winioctl.h (包括 Windows.h)

另请参阅

碎片整理

FSCTL_GET_RETRIEVAL_POINTERS

FSCTL_MOVE_FILE