FSCTL_QUERY_FILE_REGIONS IOCTL (ntifs.h)

Articolo
11/14/2023

FSCTL_QUERY_FILE_REGIONS esegue una query su un elenco di aree di file, in base a un parametro di utilizzo specificato, per il file associato all'handle in cui è stato richiamato QUESTO VALORE. Questo messaggio contiene un elemento dati FILE_REGION_INPUT facoltativo. Se non viene specificato alcun parametro FILE_REGION_INPUT , vengono restituite informazioni per l'intera dimensione del file.

Codice principale

FSCTL_QUERY_FILE_REGIONS

Buffer di input

Puntatore a una struttura FILE_REGION_INPUT che indica le aree del file da eseguire per la query.

Lunghezza del buffer di input

Dimensione della struttura FILE_REGION_INPUT a cui InputBuffer punta, in byte.

Buffer di output

Puntatore a una struttura FILE_REGION_OUTPUT in cui vengono restituiti i risultati della query.

Lunghezza del buffer di output

Dimensione del buffer a cui punta OutputBuffer , in byte.

Buffer di input/output

n/d

Lunghezza del buffer di input/output

n/d

Blocco dello stato

Riservato per l'utilizzo nel sistema.

Commenti

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

Parametro	Descrizione
Istanza	[in] Solo per FltFsControlFile . Puntatore di istanza opaco 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 della richiesta. Questo parametro è obbligatorio e non può essere NULL.
FileHandle	[in] Solo per ZwFsControlFile . Handle di file del file o della directory di destinazione della richiesta. Questo parametro è obbligatorio e non può essere NULL.
IoStatusBlock	[out] Solo per ZwFsControlFile . Puntatore a una struttura IO_STATUS_BLOCK in cui viene restituito lo stato finale della richiesta.
FsControlCode	[in] Impostare su FSCTL_QUERY_FILE_REGIONS.
Inputbuffer	[in/facoltativo] Puntatore a una struttura FILE_REGION_INPUT che indica le aree del file da eseguire per la query.
InputBufferLength	[in] Dimensione del buffer a cui InputBuffer punta, in byte.
OutputBuffer	[out] Puntatore a una struttura FILE_REGION_OUTPUT in cui vengono restituiti i risultati della query.
OutputBufferLength	[out] Dimensione del buffer a cui punta OutputBuffer , in byte.
LengthReturned	[out] Puntatore a una variabile allocata dal chiamante che riceve le dimensioni in byte delle informazioni restituite nel buffer in OutputBuffer.

Valori restituiti

FSCTL_QUERY_FILE_REGIONS restituisce STATUS_SUCCESS al completamento; in caso contrario restituisce un codice di errore. Al termine, il chiamante deve prima verificare che IoStatus.Information sia maggiore o uguale a LengthReturned prima di accedere alle informazioni restituite in OutputBuffer.