FSCTL_QUERY_FILE_REGIONS IOCTL (ntifs.h)
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 , в байтах.
Буфер входных и выходных данных
Недоступно
Длина входного/выходного буфера
Недоступно
Блок состояния
Зарезервировано для системного использования.
Комментарии
Для выполнения этой операции вызовите 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/optional] Указатель на структуру 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.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 |
| Верхняя часть | ntifs.h |
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по