VOLUME_BITMAP_BUFFER structure (winioctl.h)

  • Article

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)

Voir aussi

Défragmentation

FSCTL_GET_VOLUME_BITMAP