VOLUME_BITMAP_BUFFER-Struktur (winioctl.h)

  • Artikel

Stellt die belegten und verfügbaren Cluster auf einem Datenträger dar. Diese Struktur ist der Ausgabepuffer für den FSCTL_GET_VOLUME_BITMAP-Steuerelementcode .

Syntax

typedef struct {
  LARGE_INTEGER StartingLcn;
  LARGE_INTEGER BitmapSize;
  BYTE          Buffer[1];
} VOLUME_BITMAP_BUFFER, *PVOLUME_BITMAP_BUFFER;

Member

StartingLcn

Der LCN wird als Eingabe für den Vorgang angefordert.

BitmapSize

Die Anzahl der Cluster auf dem Volume, beginnend mit dem startenden LCN, der im StartingLcn-Member dieser Struktur zurückgegeben wird. Weitere Informationen finden Sie im abschnitt "Hinweise".

Buffer[1]

Bytearray, das die vom Vorgang zurückgegebene Bitmap enthält. Die Bitmap ist bitweise von Bit 0 der Bitmap bis zum Ende. Ab dem angeforderten Cluster geht die Bitmap also von Bit 0 von Byte 0, Bit 1 von Byte 0 ... Bit 7 von Byte 0, Bit 0 von Byte 1 usw. Der Wert 1 gibt an, dass der Cluster zugeordnet (in Verwendung) ist. Der Wert 0 gibt an, dass der Cluster nicht zugeordnet ist (frei).

Hinweise

Das BitmapSize-Element ist die Anzahl von Clustern auf dem Volume beginnend mit dem LCN-Start, der im StartingLcn-Member dieser Struktur zurückgegeben wird. Angenommen, es gibt 0xD3F7 Cluster auf dem Volume. Wenn Sie die Bitmapabfrage bei LCN 0xA007 starten, rundet sowohl das FAT- als auch das NTFS-Dateisystem den zurückgegebenen LCN-Start-LCN-0xA000. Der im BitmapSize-Element zurückgegebene Wert ist (0xD3F7 – 0xA000) oder 0x33F7.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile winioctl.h (windows.h einschließen)

Weitere Informationen

Defragmentierung

FSCTL_GET_VOLUME_BITMAP