FSCTL_SHUFFLE_FILE IOCTL (ntifs.h)

Статья
02/26/2024

FSCTL_SHUFFLE_FILE добавляет или удаляет выделение из указанного файла.

Основной код

IRP_MJ_DEVICE_CONTROL

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

Указатель на структуру 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	Перемешивание запрещено на томе, доступном только для чтения.

Параметр	Описание
Экземпляр	[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.