FSCTL_QUERY_FILE_REGIONS IOCTL (ntifs.h)

Статья
12/21/2024

FSCTL_QUERY_FILE_REGIONS запрашивает список областей файлов, основанных на указанном параметре использования, для файла, связанного с дескриптором, на котором был вызван этот FSCTL. Это сообщение содержит необязательный элемент данных FILE_REGION_INPUT. Если параметр FILE_REGION_INPUT не указан, возвращается информация для всего размера файла.

Основной код

FSCTL_QUERY_FILE_REGIONS

Входной буфер

Указатель на структуру FILE_REGION_INPUT, указывающую области файлов для запроса.

Длина входного буфера

Размер структуры FILE_REGION_INPUT, на которую InputBuffer указывает в байтах.

Выходной буфер

Указатель на FILE_REGION_OUTPUT структуру, в которой возвращаются результаты запроса.

Длина выходного буфера

Размер буфера, на который OutputBuffer указывает в байтах.

Буфер входных и выходных данных

n/a

Длина буфера ввода и вывода

n/a

Блок состояния

Зарезервировано для использования системы.

Замечания

Чтобы выполнить эту операцию, вызовите FltFsControlFile или ZwFsControlFile со следующими параметрами.

Параметр	Описание
экземпляра	[in] Только для FltFsControlFile. Непрозрачный указатель экземпляра вызывающего объекта. Этот параметр является обязательным и не может иметь значение NULL.
FileObject	[in] Только для FltFsControlFile. Указатель объекта файла для файла или каталога, который является целевым объектом этого запроса. Этот параметр является обязательным и не может иметь значение NULL.
FileHandle	[in] Только для ZwFsControlFile. Дескриптор файла или каталога, который является целевым объектом этого запроса. Этот параметр является обязательным и не может иметь значение NULL.
IoStatusBlock	[out] Только для ZwFsControlFile. Указатель на структуру IO_STATUS_BLOCK, в которой возвращается окончательное состояние запроса.
FsControlCode	[in] Установите значение FSCTL_QUERY_FILE_REGIONS.
InputBuffer	[in/необязательный] Указатель на структуру FILE_REGION_INPUT, указывающую области файлов для запроса.
InputBufferLength	[in] Размер буфера, на который InputBuffer указывает на байты.
OutputBuffer	[out] Указатель на FILE_REGION_OUTPUT структуру, в которой возвращаются результаты запроса.
OutputBufferLength	[out] Размер буфера, на который OutputBuffer указывает в байтах.
LengthReturned	[out] Указатель на выделенную вызывающим переменную, которая получает размер в байтах сведений, возвращаемых в буфере в OutputBuffer.

Возвращаемые значения

FSCTL_QUERY_FILE_REGIONS возвращает STATUS_SUCCESS после успешного завершения; в противном случае возвращается код ошибки. При успешном завершении вызывающий объект сначала должен убедиться, что IoStatus.Information больше или равно LengthReturned перед доступом к данным, возвращенным в OutputBuffer.