Compartilhar via


IOCTL_DISK_GET_PARTITION_INFO_EX IOCTL (winioctl.h)

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

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_EX, // 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

Há suporte para o código de controle IOCTL_DISK_GET_PARTITION_INFO_EX em discos básicos. Ele só tem suporte em discos dinâmicos que são discos de inicialização ou do sistema ou que têm entradas retidas na tabela de partição. O comando DiskPart.exeRETAIN pode ser usado para fazer isso para outras partições simples dinâmicas.

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 de 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