Freigeben über


FILE_REGION_INFO-Struktur (ntifs.h)

Die FILE_REGION_INFO-Struktur enthält einen berechneten Bereich einer Datei basierend auf einer gewünschten Verwendung. Diese Struktur wird verwendet, um Regionsinformationen für die FSCTL_QUERY_FILE_REGIONS-Antwortnachricht zu speichern, wobei die FILE_REGION_OUTPUT-Struktur eine oder mehrere FILE_REGION_INFO-Strukturen enthält.

Syntax

typedef struct _FILE_REGION_INFO {
  LONGLONG FileOffset;
  LONGLONG Length;
  ULONG    Usage;
  ULONG    Reserved;
} FILE_REGION_INFO, *PFILE_REGION_INFO;

Member

FileOffset

Eine 64-Bit-Ganzzahl mit Vorzeichen, die den Dateioffset des Bereichs in Byte enthält.

Length

Eine 64-Bit-Ganzzahl mit Vorzeichen, die die Größe des Bereichs in Byte enthält.

Usage

Eine 32-Bit-Ganzzahl ohne Vorzeichen, die die Verwendung für den angegebenen Bereich der Datei angibt. Die Verwendung kann einer der folgenden Werte sein.

Wert Bedeutung
0x00000000 Der angegebene Bereich ist ungültig. Es stimmt nicht mit den Kriterien des angeforderten DesiredUsage überein.
FILE_USAGE_VALID_CACHED_DATA (0x00000001) Definiert die Bereiche der Datei, die vor VDL vorhanden sind, wie sie im Cache-Manager vorhanden ist.
FILE_USAGE_VALID_NONCACHED_DATA (0x00000002) Definiert die Bereiche der Dateien, die vor VDL auf dem Speichergerät vorhanden sind.

Reserved

Reserviert; Dieses Feld sollte auf null festgelegt und ignoriert werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Kopfzeile ntifs.h

Weitere Informationen

FILE_REGION_INPUT

FILE_REGION_OUTPUT

FSCTL_QUERY_FILE_REGIONS