IOCTL_DISK_GET_PARTITION_INFO IOCTL (winioctl.h)

  • Artigo

Recupera informações sobre o tipo, o tamanho e a natureza de uma partição de disco.

Observação

IOCTL_DISK_GET_PARTITION_INFO é substituído por IOCTL_DISK_GET_PARTITION_INFO_EX, que recupera informações de partição para partições AT e EFI (Extensible Firmware Interface).

Para executar essa operação, chame a função DeviceIoControl com os parâmetros a seguir.

BOOL DeviceIoControl(
  (HANDLE) hDevice,                 // handle to a partition
  IOCTL_DISK_GET_PARTITION_INFO,    // dwIoControlCode
  NULL,                             // lpInBuffer
  0,                                // nInBufferSize
  (LPVOID) lpOutBuffer,             // output buffer
  (DWORD) nOutBufferSize,           // size of output buffer
  (LPDWORD) lpBytesReturned,        // number of bytes returned
  (LPOVERLAPPED) lpOverlapped       // OVERLAPPED structure
);

Comentários

O código de controle IOCTL_DISK_GET_PARTITION_INFO só tem suporte em discos formatados em MBR.

O suporte ao disco pode ser resumido da seguinte maneira.

Tipo de disco IOCTL_DISK_GET_PARTITION_INFO IOCTL_DISK_GET_PARTITION_INFO_EX
Registro de inicialização de master básico (MBR) Yes Yes
Tabela de partição GUID básica (GPT) No Yes
Inicialização/sistema MBR dinâmico Yes Yes
Dados MBR dinâmicos Yes No
Inicialização/sistema gpt dinâmico No Yes
Dados de GPT dinâmicos No No

Atualmente, o GPT tem suporte apenas em sistemas de 64 bits.

Se a partição estiver em um disco formatado como tipo master registro de inicialização (MBR), os totais de tamanho da partição serão limitados. Para obter mais informações, consulte a seção Comentários do IOCTL_DISK_SET_DRIVE_LAYOUT.

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