IOCTL_DISK_SET_CLUSTER_INFO código de controle
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 |
|