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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 |
| Header- | ntifs.h |