FSCTL_SHUFFLE_FILE IOCTL (ntifs.h)

Articolo
02/26/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 riassegnare.

Lunghezza del buffer di input

Dimensioni in byte del buffer di input.

Buffer di output

Nessuno; impostato su NULL.

Lunghezza del buffer di output

Imposta su zero.

Blocco dello stato

Valori restituiti

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

Codice restituito	Significato
STATUS_ACCESS_DENIED	Per vari motivi, inclusi solo le chiamate in modalità kernel sono consentite o il volume è bloccato.
STATUS_BUFFER_TOO_SMALL	La lunghezza del buffer di input specificata è inferiore alla dimensioneof(SHUFFLE_FILE_DATA).
STATUS_MEDIA_WRITE_PROTECTED	Lo shuffling non è consentito in un volume di sola lettura.

Commenti

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
Istanza	[in] Solo per FltFsControlFile . Puntatore opaco dell'istanza per il chiamante. Questo parametro è obbligatorio e non può essere NULL.
FileObject	[in] Solo per FltFsControlFile . Puntatore a oggetti file per il file o la directory di destinazione di questa richiesta. Questo parametro è obbligatorio e non può essere NULL.
FileHandle	[in] Solo per ZwFsControlFile . Handle file del file o della directory di 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.