QUERY_FILE_LAYOUT_INPUT-Struktur (ntifs.h)

Die QUERY_FILE_LAYOUT_INPUT-Struktur wählt aus, welche Dateilayouteinträge von einer FSCTL_QUERY_FILE_LAYOUT-Anforderung zurückgegeben werden.

Syntax

typedef struct _QUERY_FILE_LAYOUT_INPUT {
  union {
    ULONG FilterEntryCount;
    ULONG NumberOfPairs;
  } DUMMYUNIONNAME;
  ULONG                         Flags;
  QUERY_FILE_LAYOUT_FILTER_TYPE FilterType;
  ULONG                         Reserved;
  union {
    CLUSTER_RANGE        ClusterRanges[1];
    FILE_REFERENCE_RANGE FileReferenceRanges[1];
    STORAGE_RESERVE_ID   StorageReserveIds[1];
  } Filter;
} QUERY_FILE_LAYOUT_INPUT, *PQUERY_FILE_LAYOUT_INPUT;

Member

DUMMYUNIONNAME

DUMMYUNIONNAME.FilterEntryCount

Die Anzahl der Filtereinträge im Filterarray .

DUMMYUNIONNAME.NumberOfPairs

Der ursprüngliche Name des Felds, wenn nur ein Filtertyp vorhanden war. Die Union dient lediglich der Aufrechterhaltung der Codekompatibilität.

Flags

Gibt an, welche Dateilayouteinträge in den Abfrageergebnissen enthalten sind. Flags ist auf eine gültige Kombination der folgenden Werte festgelegt.

FilterType

Gibt eine Filtermethode an, um zurückgegebene Layoutinformationen einzuschränken. Dies kann einer der folgenden Werte sein.

Reserved

Ist für das System reserviert.

Filter

Ein Array von Filterstrukturen, die zum Auswählen bestimmter Layoutinformationen verwendet werden. Diese enthalten entweder Cluster- oder Dateiverweisbereiche. Die Arraylänge wird vom NumberOfPairs-Element angegeben. Jeder Bereich muss unterschiedlich sein und darf sich nicht mit einem anderen Bereich überschneiden.

Dieser Member wird ignoriert, wenn QUERY_FILE_LAYOUT_FILTER_TYPE_NONE in FilterType angegeben ist.

Filter.ClusterRanges[1]

Gibt einen Satz von Clusterbereichen an, um Layoutinformationen zu filtern. Die Bereichsstruktur hat das folgende Format.

typedef struct _CLUSTER_RANGE {
    LARGE_INTEGER    StartingCluster;
    LARGE_INTEGER    ClusterCount;
} CLUSTER_RANGE, *PCLUSTER_RANGE;

Filter.FileReferenceRanges[1]

Gibt einen Satz von Dateiverweisbereichen an, um Layoutinformationen zu filtern. Verfügbar ab Windows 10 Version 1809. Die Bereichsstruktur hat das folgende Format.

typedef struct _FILE_REFERENCE_RANGE {
    LARGE_INTEGER    StartingFileReference;
    LARGE_INTEGER    EndingReferenceNumber;
} FILE_REFERENCE_RANGE, *PFILE_REFERENCE_RANGE;

Filter.StorageReserveIds[1]

Gibt einen Satz von Speicherreserve-IDs an, um Layoutinformationen zu filtern. Die zugeordnete Enumeration hat das folgende Format.

typedef enum _STORAGE_RESERVE_ID {

    StorageReserveIdNone = 0,
    StorageReserveIdHard,
    StorageReserveIdSoft,
    StorageReserveIdUpdateScratch,

    StorageReserveIdMax

} STORAGE_RESERVE_ID, *PSTORAGE_RESERVE_ID;

Hinweise

Das QUERY_FILE_LAYOUT_RESTART-Flag wird für die erste FSCTL_QUERY_FILE_LAYOUT-Anforderung festgelegt. Wenn Filterbereiche in der Anforderung enthalten sind, werden sie zwischengespeichert, wenn QUERY_FILE_LAYOUT_RESTART festgelegt ist. Weitere Anforderungen geben Layoutdateieinträge bis zum Ende des Volumes oder bis zum Erschöpfen der Filterbereiche zurück.

Wenn QUERY_FILE_LAYOUT_RESTART für dasselbe Volume erneut festgelegt wird, wird die Dateilayoutposition auf den Anfang des Volumes zurückgesetzt. Darüber hinaus werden die Filterbereiche neu zwischengespeichert, und ihre Auswertungsreihenfolge wird auf den ersten Bereich zurückgesetzt.

Die Dateilayouteinträge werden im Ausgabepuffer nach einer QUERY_FILE_LAYOUT_OUTPUT-Struktur zurückgegeben.

Wenn FilterTypeQUERY_FILE_LAYOUT_FILTER_TYPE_CLUSTERS ist, wird das ClusterRanges-Element der Filterunion für die Bereichsfilterung verwendet. Wenn FilterTypeQUERY_FILE_LAYOUT_FILTER_TYPE_FILEID ist, wird andernfalls das FileReferenceRanges-Element für die Bereichsfilterung verwendet.

Anforderungen

Weitere Informationen

FSCTL_QUERY_FILE_LAYOUT

QUERY_FILE_LAYOUT_OUTPUT