FSCTL_QUERY_FILE_REGIONS IOCTL (ntifs.h)

Articolo
12/21/2024

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 su cui è stato richiamato il file DALLTL. Questo messaggio contiene un elemento dati facoltativo FILE_REGION_INPUT. 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 su cui eseguire la query.

Lunghezza del buffer di input

Dimensioni della struttura FILE_REGION_INPUT che 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

Dimensioni del buffer a cui OutputBuffer punta, in byte.

Buffer di input/output

n/a

Lunghezza del buffer di input/output

n/a

Blocco di stato

Riservato per l'uso del sistema.

Osservazioni

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 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 su cui eseguire la query.
inputBufferLength	[in] Dimensioni 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] Dimensioni del buffer a cui OutputBuffer punta, in byte.
lengthReturned	[out] Puntatore a una variabile allocata dal chiamante che riceve le dimensioni in byte delle informazioni restituite nel buffer in corrispondenza di OutputBuffer.

Valori restituiti

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