структура RETRIEVAL_POINTERS_BUFFER (winioctl.h)

Статья
03/06/2025

Содержит выходные данные для кода элемента управления FSCTL_GET_RETRIEVAL_POINTERS.

Синтаксис

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

Члены

ExtentCount

Количество элементов в массиве Экстентов.

StartingVcn

Начальный VCN, возвращаемый вызовом функции. Это не обязательно VCN, запрошенный вызовом функции, так как драйвер файловой системы может округить до первой VCN степени, в которой найден запрошенный начальный VCN.

NextVcn

Lcn

Extents[1]

Массив экстентов структур. Количество элементов в массиве см. в разделе ExtentCount. Каждый элемент массива содержит следующие элементы.

NextVcn

VCN, с которого начинается следующая степень. Это значение минус StartingVcn (для первого члена массива экстентов) или NextVcn предыдущего элемента массива (для всех остальных элементов массива экстентов) — это длина в кластерах текущего экстента. Длина — это входные данные для операции 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

Поделиться через