QUERY_FILE_LAYOUT_OUTPUT-Struktur (ntifs.h)

Artikel
08/07/2023

Die QUERY_FILE_LAYOUT_OUTPUT-Struktur dient als Header für die Dateilayouteinträge, die von einer FSCTL_QUERY_FILE_LAYOUT-Anforderung zurückgegeben werden.

Syntax

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

Member

FileEntryCount

Die Anzahl der Dateieinträge, die dieser Struktur folgen.

FirstFileOffset

Der Offset im Benutzerpuffer für den ersten Dateieintrag.

Flags

Gibt das Format der zurückgegebenen Layouteinträge an. Kann 0 oder folgendes sein:

Wert	Bedeutung
QUERY_FILE_LAYOUT_SINGLE_INSTANCED	Einzelne Instanzen von Stream- und Dateilayouteinträgen werden zurückgegeben. Wenn festgelegt, wird pro Stream nur eine STREAM_LAYOUT_ENTRY-Struktur zurückgegeben, und pro Datei wird nur eine FILE_LAYOUT_ENTRY-Struktur zurückgegeben. Dieses Flag ist für NTFS immer festgelegt.

Reserved

Reserviert.

Hinweise

Die Dateilayouteinträge, die der QUERY_FILE_LAYOUT_OUTPUT-Struktur folgen, werden durch die Flags bestimmt, die im Flags-Member von QUERY_FILE_LAYOUT_INPUT als Eingabe für die FSCTL_QUERY_FILE_LAYOUT-Anforderung festgelegt sind. Eine Reihe von FILE_LAYOUT_ENTRY Strukturen folgen QUERY_FILE_LAYOUT_OUTPUT. Abhängig von den einträgen, die aus einer Abfrage zurückgegeben werden sollen, geben Offsets in FILE_LAYOUT_ENTRY angeben, wo sich die zusätzlichen Informationseinträge im Benutzerpuffer befinden.

Die folgenden Eintragsstrukturen werden zurückgegeben, wenn das entsprechende Einschlussflag im Flags-Member von QUERY_FILE_LAYOUT_INPUT festgelegt ist.

Eingabe	Inklusionsflag
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

Wenn mehrere Einträge desselben Typs für eine einzelne FILE_LAYOUT_ENTRY-Struktur vorhanden sind, verfügt jede Informationseintragsstruktur über einen Offsetmember, der die Position des nächsten Eintrags angibt. Die Kette der Einstiegsstrukturen wird fortgesetzt, bis der Wert des Offsetelements 0 ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.
Kopfzeile	ntifs.h (include Ntifs.h)

Weitere Informationen

FSCTL_QUERY_FILE_LAYOUT

QUERY_FILE_LAYOUT_INPUT

Freigeben über