VOLUME_BITMAP_BUFFER structure (ntifs.h)
The VOLUME_BITMAP_BUFFER structure contains a bitmap of occupied and available clusters on a disk. This structure is the output buffer for the FSCTL_GET_VOLUME_BITMAP control code.
Syntax
typedef struct {
LARGE_INTEGER StartingLcn;
LARGE_INTEGER BitmapSize;
UCHAR Buffer[1];
} VOLUME_BITMAP_BUFFER, *PVOLUME_BITMAP_BUFFER;
Members
StartingLcn
Starting logical cluster number (LCN) requested as an input to the operation.
BitmapSize
Number of clusters on the volume, starting from the starting LCN returned in StartingLcn.
Buffer[1]
Array of bytes containing the bitmap that the operation returns. The bitmap is bitwise from bit zero of the bitmap to the end. Thus, starting at the requested cluster, the bitmap goes from bit 0 of byte 0, bit 1 of byte 0 ... bit 7 of byte 0, bit 0 of byte 1, and so on. The value 1 indicates that the cluster is allocated (in use). The value 0 indicates that the cluster is not allocated (free).
Remarks
BitmapSize is the number of clusters on the volume starting from StartingLcn. For example, suppose there are 0xD3F7 clusters on the volume. If you start the bitmap query at LCN 0xA007, then both the FAT and NTFS file systems will round down the returned starting LCN to LCN 0xA000. The value returned in the BitmapSize member will be (0xD3F7 – 0xA000), or 0x33F7.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP |
| Header | ntifs.h |