código de controle IOCTL_DISK_GET_CLUSTER_INFO

Recupera os atributos do dispositivo de disco especificado.

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

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

Parâmetros

hDevice

Um identificador para o disco.

Para recuperar um identificador de dispositivo, chame a função CreateFile .

Dwiocontrolcode

O código de controle da operação.

Use IOCTL_DISK_GET_CLUSTER_INFO para esta operação.

lpInBuffer

Não usado com essa operação. Definido como NULL.

nInBufferSize

O tamanho do buffer de entrada, em bytes. Definido como 0 (zero).

Lpoutbuffer

Um ponteiro para um buffer que recebe uma estrutura de dados DISK_CLUSTER_INFO .

nOutBufferSize

O tamanho do buffer de saída em bytes.

Lpbytesreturned

Não usado com essa operação. Definido como NULL.

Lpoverlapped

Um ponteiro para uma estrutura OVERLAPPED .

Se hDevice foi aberto sem especificar FILE_FLAG_OVERLAPPED, lpOverlapped será ignorado.

Se hDevice foi aberto com o sinalizador FILE_FLAG_OVERLAPPED , a operação é executada como uma operação sobreposta (assíncrona). Nesse caso, lpOverlapped deve apontar para uma estrutura OVERLAPPED válida que contém um identificador para um objeto de evento. Caso contrário, a função falhará de maneiras imprevisíveis.

Para operações sobrepostas, DeviceIoControl retorna imediatamente e o objeto de evento é sinalizado quando a operação é concluída. Caso contrário, a função não retornará até que a operação seja concluída ou ocorra um erro.

Retornar valor

Se a operação for concluída com êxito, indicando que todos os volumes no disco estão prontos para uso, DeviceIoControl retornará um valor diferente de zero.

Se a operação falhar ou estiver pendente, DeviceIoControl retornará zero. Para obter informações de erro estendidas, chame GetLastError.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Nenhum compatível
Servidor mínimo com suporte
Windows Server 2012 [somente aplicativos da área de trabalho]
Cabeçalho
Ntdddisk.h

Confira também

Deviceiocontrol

Códigos de controle de gerenciamento de disco

DISK_CLUSTER_INFO

IOCTL_DISK_SET_CLUSTER_INFO