FSCTL_QUERY_FILE_REGIONS IOCTL (ntifs.h)
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.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 8 |
Intestazione | ntifs.h |
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per