FSCTL_SHUFFLE_FILE IOCTL (ntifs.h)

Artigo
04/19/2023

FSCTL_SHUFFLE_FILE adiciona ou remove a alocação de dentro do arquivo especificado.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Ponteiro para uma estrutura SHUFFLE_FILE_DATA que descreve a alocação a ser embaralhada.

Comprimento do buffer de entrada

Tamanho em bytes do buffer de entrada.

Buffer de saída

Nenhum; defina como NULL.

Comprimento do buffer de saída

Defina como zero.

Bloco de status

Valores retornados

FSCTL_SHUFFLE_FILE retorna STATUS_SUCCESS após a conclusão bem-sucedida; caso contrário, ele retornará um código NTSTATUS, como um dos seguintes.

Código de retorno	Significado
STATUS_ACCESS_DENIED	Por vários motivos, incluindo apenas chamadas de modo kernel são permitidas ou o volume está bloqueado.
STATUS_BUFFER_TOO_SMALL	O comprimento do buffer de entrada especificado é menor que sizeof(SHUFFLE_FILE_DATA).
STATUS_MEDIA_WRITE_PROTECTED	A ordem aleatória não é permitida em um volume somente leitura.

Comentários

Esse código de controle fará com que os dados mudem dentro do arquivo. O chamador é responsável por proteger/apagar os dados aleatórios dentro da alocação adicionada.

Para executar essa operação, chame FltFsControlFile ou ZwFsControlFile com os parâmetros a seguir.

Parâmetro	Descrição
Instância	[in] Somente para FltFsControlFile . Um ponteiro de instância opaco para o chamador. Esse parâmetro é necessário e não pode ser NULL.
FileObject	[in] Somente para FltFsControlFile . Um ponteiro de objeto de arquivo para o arquivo ou diretório que é o destino dessa solicitação. Esse parâmetro é necessário e não pode ser NULL.
FileHandle	[in] Somente para ZwFsControlFile . Identificador de arquivo do arquivo ou diretório que é o destino dessa solicitação. Esse parâmetro é necessário e não pode ser NULL.
IoStatusBlock	[out] Somente para ZwFsControlFile . Ponteiro para uma estrutura IO_STATUS_BLOCK que contém o status final da solicitação.
FsControlCode	[in] Defina como FSCTL_SHUFFLE_FILE.
Inputbuffer	[in] Confira Parâmetros IOCTL.
InputBufferLength	[in] Confira Parâmetros IOCTL.