FILE_ALLOCATED_RANGE_BUFFER Struktur (ntifs.h)

  • Artikel

FILE_ALLOCATED_RANGE_BUFFER Strukturen werden während einer FSCTL_QUERY_ALLOCATED_RANGES Codeanforderung als Eingabe und Ausgabe verwendet.

Syntax

typedef struct _FILE_ALLOCATED_RANGE_BUFFER {
  LARGE_INTEGER FileOffset;
  LARGE_INTEGER Length;
} FILE_ALLOCATED_RANGE_BUFFER, *PFILE_ALLOCATED_RANGE_BUFFER;

Member

FileOffset

Enthält bei FSCTL-Eingabe den Dateioffset in Bytes des Anfangs eines Bytesbereichs in einer Datei. FileOffset muss größer oder gleich 0 sein.

Enthält in der FSCTL-Ausgabe den Dateioffset in Bytes vom Anfang der Datei; der Anfang eines Bytesbereichs, dem Speicher zugeordnet ist. Wenn es sich bei der Datei um eine Sparsedatei handelt, kann FileOffset Bytesbereiche enthalten, für die der Speicher nicht zugeordnet ist. diese Bereiche werden aus der Liste der zugeordneten Bereiche ausgeschlossen, die von FSCTL_QUERY_ALLOCATED_RANGES zurückgegeben werden. Da eine Anwendung, die eine Sparsedatei verwendet, auswählen kann, ob für jede Sequenz von 0x00 Bytes Speicherplatz zugewiesen werden soll oder nicht, können die zugeordneten Bereiche 0x00-Wertbytes enthalten. Dieser Wert muss bei der Ausgabe größer oder gleich 0 sein.

Length

Enthält die Größe des Bereichs in Bytes. Bei DER FSCTL-Eingabe muss die Länge größer oder gleich 0 sein. Bei der FSCTL-Ausgabe muss die Länge größer als 0 sein.

Anforderungen

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

Weitere Informationen

FSCTL_QUERY_ALLOCATED_RANGES