FILE_ALLOCATED_RANGE_BUFFER Struktur (ntifs.h)

FILE_ALLOCATED_RANGE_BUFFER Strukturen werden während einer FSCTL_QUERY_ALLOCATED_RANGES Steuerelementcodeanforderung 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;

Angehörige

FileOffset

Enthält auf FSCTL-Eingaben den Dateioffset in Byte des Anfangs eines Bytebereichs in einer Datei. FileOffset- muss größer oder gleich 0 sein.

Enthält auf der FSCTL-Ausgabe den Dateioffset in Byte vom Anfang der Datei; der Anfang eines Bytebereichs, dem Speicher zugeordnet ist. Wenn es sich bei der Datei um eine sparse Datei handelt, kann FileOffset- Bereiche von Bytes enthalten, für die kein Speicher zugeordnet ist; Diese Bereiche werden aus der Liste der zugewiesenen Bereiche ausgeschlossen, die von FSCTL_QUERY_ALLOCATED_RANGESzurückgegeben werden. Da eine Anwendung, die eine sparse-Datei verwendet, auswählen kann, ob für jede Sequenz von 0x00 wertigen Bytes Speicherplatz zugewiesen werden soll, können die zugeordneten Bereiche 0x00-wertige Bytes enthalten. Dieser Wert muss größer oder gleich 0 für die Ausgabe sein.

Length

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

Anforderungen

Siehe auch

FSCTL_QUERY_ALLOCATED_RANGES