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

Статья
03/13/2024

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

Синтаксис

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

Члены

ExtentCount

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

StartingVcn

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

NextVcn

Lcn

Extents[1]

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

NextVcn

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

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