FSCTL_SHUFFLE_FILE IOCTL (ntifs.h)

Articolo
12/21/2024

FSCTL_SHUFFLE_FILE aggiunge o rimuove l'allocazione dall'interno del file specificato.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Puntatore a una struttura SHUFFLE_FILE_DATA che descrive l'allocazione da spostare in sequenza casuale.

Lunghezza del buffer di input

Dimensioni in byte del buffer di input.

Buffer di output

Nessuno; impostato su NULL.

Lunghezza del buffer di output

Impostare su zero.

Blocco di stato

Valori restituiti

FSCTL_SHUFFLE_FILE restituisce STATUS_SUCCESS al completamento; in caso contrario, restituisce un codice NTSTATUS, ad esempio uno dei seguenti.

Codice restituito	Significato
STATUS_ACCESS_DENIED	Per vari motivi, incluse solo le chiamate in modalità kernel sono consentite o il volume è bloccato.
STATUS_BUFFER_TOO_SMALL	La lunghezza del buffer di input specificata è minore di sizeof(SHUFFLE_FILE_DATA).
STATUS_MEDIA_WRITE_PROTECTED	La sequenza casuale non è consentita in un volume di sola lettura.

Osservazioni

Questo codice di controllo causerà lo spostamento dei dati all'interno del file. Il chiamante è responsabile della protezione/cancellazione dei dati casuali all'interno dell'allocazione aggiunta.

Per eseguire questa operazione, chiamare FltFsControlFile o ZwFsControlFile con i parametri seguenti.

Parametro	Descrizione
dell'istanza di	[in] Solo per FltFsControlFile. Puntatore a un'istanza opaca per il chiamante. Questo parametro è obbligatorio e non può essere NULL.
FileObject	[in] Solo per FltFsControlFile. Puntatore all'oggetto file per il file o la directory che rappresenta la destinazione di questa richiesta. Questo parametro è obbligatorio e non può essere NULL.
fileHandle	[in] Solo per ZwFsControlFile. Handle di file del file o della directory che rappresenta la destinazione di questa richiesta. Questo parametro è obbligatorio e non può essere NULL.
IoStatusBlock	[out] Solo per ZwFsControlFile. Puntatore a una struttura IO_STATUS_BLOCK che contiene lo stato finale della richiesta.
FsControlCode	[in] Impostare su FSCTL_SHUFFLE_FILE.
InputBuffer	[in] Vedere Parametri IOCTL.
inputBufferLength	[in] Vedere Parametri IOCTL.