QUERY_FILE_LAYOUT_OUTPUT Struktur (ntifs.h)

Die QUERY_FILE_LAYOUT_OUTPUT-Struktur dient als Kopfzeile 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;

Angehörige

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 Datenstrom- und Dateilayouteinträgen werden zurückgegeben. Bei Festlegung wird pro Datenstrom nur eine STREAM_LAYOUT_ENTRY Struktur zurückgegeben, und pro Datei wird nur eine FILE_LAYOUT_ENTRY Struktur zurückgegeben. Dieses Kennzeichen ist immer für NTFS festgelegt.

Reserved

Reserviert.

Bemerkungen

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 bereitgestellt werden. 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 an, wo sich die zusätzlichen Informationseinträge im Benutzerpuffer befinden.

Die folgenden Eintragsstrukturen werden zurückgegeben, wenn ihre entsprechende Einschlusskennzeichnung im Flags Element von QUERY_FILE_LAYOUT_INPUTfestgelegt wird.

Eintrag	Einschlusskennzeichnung
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 für eine einzelne FILE_LAYOUT_ENTRY Struktur mehrere Einträge desselben Typs vorhanden sind, weist jede Informationseintragsstruktur ein Offsetelement auf, das die Position des nächsten Eintrags angibt. Die Kette der Einstiegsstrukturen wird fortgesetzt, bis der Wert des Offsetelements 0 ist.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows 8.
Header-	ntifs.h (einschließlich Ntifs.h)

Siehe auch

FSCTL_QUERY_FILE_LAYOUT

QUERY_FILE_LAYOUT_INPUT