IOCTL_DISK_SET_CLUSTER_INFO código de controle

Artigo
06/12/2023

Define as informações do cluster em um disco.

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_SET_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_SET_CLUSTER_INFO para esta operação.

lpInBuffer

Um ponteiro para uma estrutura de dados DISK_CLUSTER_INFO que contém informações de cluster para o disco.

nInBufferSize

O tamanho do buffer de entrada, em bytes.

Lpoutbuffer

Não usado com esta operação. Defina como NULL.

nOutBufferSize

O tamanho do buffer de saída em bytes. Defina como 0 (zero).

Lpbytesreturned

Não usado com esta operação. Defina 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 contenha 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.

Valor retornado

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_GET_CLUSTER_INFO