struttura QUERY_FILE_LAYOUT_OUTPUT (ntifs.h)

Articolo
02/26/2024

La struttura QUERY_FILE_LAYOUT_OUTPUT funge da intestazione per le voci di layout del file restituite da una richiesta di FSCTL_QUERY_FILE_LAYOUT .

Sintassi

typedef struct _QUERY_FILE_LAYOUT_OUTPUT {
  ULONG FileEntryCount;
  ULONG FirstFileOffset;
  ULONG Flags;
  ULONG Reserved;
} QUERY_FILE_LAYOUT_OUTPUT, *PQUERY_FILE_LAYOUT_OUTPUT;

Members

FileEntryCount

Numero di voci di file che seguono questa struttura.

FirstFileOffset

Offset nel buffer utente per la prima voce di file.

Flags

Indica il formato delle voci di layout restituite. Può essere 0 o il seguente:

Valore	Significato
QUERY_FILE_LAYOUT_SINGLE_INSTANCED	Vengono restituite singole istanze di voci di layout di flusso e file. Se impostato, viene restituita una sola struttura STREAM_LAYOUT_ENTRY per flusso e viene restituita una sola struttura FILE_LAYOUT_ENTRY per ogni file. Questo flag è sempre impostato per NTFS.

Reserved

Riservato.

Commenti

Le voci di layout del file che seguono la struttura QUERY_FILE_LAYOUT_OUTPUT sono determinate dai flag impostati nel membro Flags di QUERY_FILE_LAYOUT_INPUT forniti come input per la richiesta di FSCTL_QUERY_FILE_LAYOUT . Alcune strutture di FILE_LAYOUT_ENTRY seguono QUERY_FILE_LAYOUT_OUTPUT. A seconda delle voci selezionate per la restituzione da una query, gli offset in FILE_LAYOUT_ENTRY indicano dove si trovano le voci informative aggiuntive nel buffer utente.

Le strutture di immissione seguenti vengono restituite quando il flag di inclusione corrispondente viene impostato nel membro Flags di QUERY_FILE_LAYOUT_INPUT.

Voce	Flag di inclusione
FILE_LAYOUT_NAME_ENTRY	QUERY_FILE_LAYOUT_INCLUDE_NAMES
FILE_LAYOUT_INFO_ENTRY	QUERY_FILE_LAYOUT_INCLUDE_EXTRA_INFO
STREAM_LAYOUT_ENTRY	QUERY_FILE_LAYOUT_INCLUDE_STREAMS
STREAM_EXTENT_ENTRY	QUERY_FILE_LAYOUT_INCLUDE_EXTENTS

Quando esistono più voci dello stesso tipo per una singola struttura FILE_LAYOUT_ENTRY , ogni struttura di immissione informativa ha un membro offset che indica la posizione della voce successiva. La catena di strutture di immissione continua fino a quando il valore del membro di offset è 0.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 8.
Intestazione	ntifs.h (include Ntifs.h)

Vedi anche

FSCTL_QUERY_FILE_LAYOUT

QUERY_FILE_LAYOUT_INPUT

Condividi tramite