FSCTL_SHUFFLE_FILE IOCTL (ntifs.h)
FSCTL_SHUFFLE_FILE добавляет или удаляет выделение из указанного файла.
Основной код
Входной буфер
Указатель на структуру SHUFFLE_FILE_DATA , описывающую распределение, которое необходимо перемешивать.
Длина входного буфера
Размер входного буфера в байтах.
Выходной буфер
Ни один; для параметра задано значение NULL.
Длина выходного буфера
Задайте нулевое значение.
Блок состояния
Возвращаемые значения
FSCTL_SHUFFLE_FILE возвращает STATUS_SUCCESS после успешного завершения; В противном случае возвращается код NTSTATUS, например один из следующих.
| Код возврата | Значение |
|---|---|
| STATUS_ACCESS_DENIED | По различным причинам разрешены вызовы только в режиме ядра или том заблокирован. |
| STATUS_BUFFER_TOO_SMALL | Указанная длина входного буфера меньше, чем sizeof(SHUFFLE_FILE_DATA). |
| STATUS_MEDIA_WRITE_PROTECTED | Перемешивание запрещено на томе, доступном только для чтения. |
Комментарии
Этот управляющий код приведет к смещению данных в файле. Вызывающий объект отвечает за защиту или удаление случайных данных в добавленном выделении.
Для выполнения этой операции вызовите FltFsControlFile или ZwFsControlFile со следующими параметрами.
| Параметр | Описание |
|---|---|
| Экземпляр | [in] Только для FltFsControlFile . Указатель непрозрачного экземпляра для вызывающего объекта. Этот параметр является обязательным и не может иметь значение NULL. |
| FileObject | [in] Только для FltFsControlFile . Указатель файлового объекта для файла или каталога, которые являются целевым объектом этого запроса. Этот параметр является обязательным и не может иметь значение NULL. |
| FileHandle | [in] Только для ZwFsControlFile . Дескриптор файла или каталога, который является целевым объектом этого запроса. Этот параметр является обязательным и не может иметь значение NULL. |
| IoStatusBlock | [out] Только для ZwFsControlFile . Указатель на структуру IO_STATUS_BLOCK , которая содержит окончательное состояние запроса. |
| FsControlCode | [in] Задайте значение FSCTL_SHUFFLE_FILE. |
| InputBuffer | [in] См. раздел Параметры IOCTL. |
| InputBufferLength | [in] См. раздел Параметры IOCTL. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 10, версия 1809 |
| Верхняя часть | ntifs.h |