VOLUME_BITMAP_BUFFER structure (winioctl.h)
Représente les clusters occupés et disponibles sur un disque. Cette structure est la mémoire tampon de sortie pour le code de contrôle FSCTL_GET_VOLUME_BITMAP .
Syntaxe
typedef struct {
LARGE_INTEGER StartingLcn;
LARGE_INTEGER BitmapSize;
BYTE Buffer[1];
} VOLUME_BITMAP_BUFFER, *PVOLUME_BITMAP_BUFFER;
Membres
StartingLcn
Démarrage de LCN demandé en tant qu’entrée de l’opération.
BitmapSize
Nombre de clusters sur le volume, à partir du LCN de départ retourné dans le membre StartingLcn de cette structure. Pour plus d’informations, consultez la section Notes suivante.
Buffer[1]
Tableau d’octets contenant la bitmap retournée par l’opération. La bitmap est au niveau du bit zéro de la bitmap jusqu’à la fin. Ainsi, à partir du cluster demandé, la bitmap va du bit 0 de l’octet 0, du bit 1 de l’octet 0 ... bit 7 de l’octet 0, bit 0 de l’octet 1, et ainsi de suite. La valeur 1 indique que le cluster est alloué (en cours d’utilisation). La valeur 0 indique que le cluster n’est pas alloué (gratuit).
Remarques
Le membre BitmapSize est le nombre de clusters sur le volume à partir du LCN de départ retourné dans le membre StartingLcn de cette structure. Par exemple, supposons qu’il existe 0xD3F7 clusters sur le volume. Si vous démarrez la requête bitmap à l'0xA007 LCN, les systèmes de fichiers FAT et NTFS arrondiront le LCN de départ retourné à LCN 0xA000. La valeur retournée dans le membre BitmapSize sera (0xD3F7 – 0xA000) ou 0x33F7.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| En-tête | winioctl.h (inclure Windows.h) |