Код элемента управления FSCTL_OFFLOAD_READ

Статья
03/14/2023

Код элемента управления FSCTL_OFFLOAD_READ инициирует разгрузку чтения для блока данных в системе хранения, которая поддерживает примитивы чтения разгрузки.

Для выполнения этой операции вызовите FltFsControlFile или ZwFsControlFile со следующими параметрами.

Параметры

Экземпляр [in]: только FltFsControlFile . Указатель непрозрачного экземпляра для вызывающего объекта. Этот параметр является обязательным и не может иметь значение NULL.
FileObject [in]: только FltFsControlFile . Объект указателя на файл, указывающий файл для чтения. Этот параметр является обязательным и не может иметь значение NULL.
FileHandle [in]: только ZwFsControlFile . Дескриптор файла для чтения. Этот параметр является обязательным и не может иметь значение NULL.
FsControlCode [in]: код элемента управления для операции. Используйте FSCTL_OFFLOAD_READ для этой операции.
InputBuffer [in]: указатель на структуру FSCTL_OFFLOAD_READ_INPUT , которая содержит размер и смещение считываемого блока данных.
InputBufferLength [in]: размер (в байтах) буфера, на который указывает InputBuffer. Это значение равно sizeof(FSCTL_OFFLOAD_READ_INPUT).
OutputBuffer [out]: указатель на структуру FSCTL_OFFLOAD_READ_OUTPUT , которая получает результаты операции чтения разгрузки.
OutputBufferLength [out]: размер в байтах буфера, на который указывает параметр OutputBuffer . Это значение должно быть по крайней мере sizeof(FSCTL_OFFLOAD_READ_OUTPUT).

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

FltFsControlFile или ZwFsControlFile возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае соответствующая функция может вернуть одно из следующих значений NTSTATUS.

Код	Значение
STATUS_INVALID_DEVICE_REQUEST	Указанный дескриптор не является допустимым дескриптором файла
STATUS_INVALID_PARAMETER	Недопустимый параметр. См. заметки.
STATUS_VOLUME_DISMOUNTED	Том файловой системы отключен.
STATUS_NOT_SUPPORTED	Операции разгрузки чтения на этом томе не поддерживаются.
STATUS_OFFLOAD_READ_FILE_NOT_SUPPORTED	Запрошенный тип файла не поддерживается. Операции разгрузки не поддерживаются для файлов следующих типов: файл с транзакцией (TxF); Файлы, не являющиеся пользователями; Сжатые файлы; Зашифрованные файлы; Разреженные файлы; Файлы metatdata NTFS.
STATUS_FILE_DELETED	Недопустимый поток данных для этого файла.
STATUS_FILE_CLOSED	Дескриптор файла закрыт.
STATUS_INVALID_HANDLE	Указан недопустимый дескриптор файла.
STATUS_FILE_LOCK_CONFLICT	Недостаточный доступ на чтение из-за текущего состояния блокировки файла.
STATUS_END_OF_FILE	Элемент FileOffsetFSCTL_OFFLOAD_READ_INPUT начинается после окончания файла (EOF).
STATUS_DISMOUNTED_VOLUME	Чтение разгрузки не может произойти на отключенном томе.
STATUS_INSUFFICIENT_RESOUCES	Недостаточно ресурсов для выполнения запроса.
STATUS_BUFFER_TOO_SMALL	OutputBufferLength слишком мал, чтобы OutputBuffer получил структуру FSCTL_OFFLOAD_READ_OUTPUT .

Размер файла меньше PAGE_SIZE.
InputBufferLength<sizeof(FSCTL_OFFLOAD_READ_INPUT).
Один или несколько из этих элементов FSCTL_OFFLOAD_READ_INPUT являются неверными:
- FileOffset не является кратным размеру логического сектора тома.
- CopyLength не является кратным размеру логического сектора тома.
- Размер не является размером структуры FSCTL_OFFLOAD_READ_INPUT .
- FileOffset + CopyLength>MAXULONGLONG.