структура FILE_ALLOCATED_RANGE_BUFFER (ntifs.h)

Статья
08/07/2023

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.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000
Верхняя часть	ntifs.h

См. также раздел

FSCTL_QUERY_ALLOCATED_RANGES

Share via