estrutura VOLUME_BITMAP_BUFFER (winioctl.h)

Representa os clusters ocupados e disponíveis em um disco. Essa estrutura é o buffer de saída para o código de controle FSCTL_GET_VOLUME_BITMAP .

Sintaxe

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

Membros

StartingLcn

Iniciando o LCN solicitado como uma entrada para a operação.

BitmapSize

O número de clusters no volume, começando pelo LCN inicial retornado no membro StartingLcn dessa estrutura. Consulte a seção Comentários a seguir para obter detalhes.

Buffer[1]

Matriz de bytes que contém o bitmap retornado pela operação. O bitmap é bit a bit do bit zero do bitmap até o final. Portanto, começando no cluster solicitado, o bitmap vai do bit 0 de byte 0, bit 1 de byte 0 ... bit 7 de byte 0, bit 0 de byte 1 e assim por diante. O valor 1 indica que o cluster está alocado (em uso). O valor 0 indica que o cluster não está alocado (gratuito).

Comentários

O membro BitmapSize é o número de clusters no volume a partir do LCN inicial retornado no membro StartingLcn dessa estrutura. Por exemplo, suponha que haja 0xD3F7 clusters no volume. Se você iniciar a consulta de bitmap no LCN 0xA007, os sistemas de arquivos FAT e NTFS arredondarão o LCN inicial retornado para o LCN 0xA000. O valor retornado no membro BitmapSize será (0xD3F7 – 0xA000) ou 0x33F7.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	winioctl.h (inclua Windows.h)

Confira também

Vantagens da desfragmentação

FSCTL_GET_VOLUME_BITMAP