Compartilhar via


IOCTL_DISK_ARE_VOLUMES_READY código de controle

Aguarda que todos os volumes no disco especificado estejam prontos para uso.

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_ARE_VOLUMES_READY,   // dwIoControlCode
                 (LPVOID)       NULL,            // lpInBuffer 
                 (DWORD)        0,               // nInBufferSize 
                 (LPVOID)       NULL,            // lpOutBuffer 
                 (DWORD)        0,               // nOutBufferSize
                 (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_ARE_VOLUMES_READY para esta operação.

lpInBuffer

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

nInBufferSize

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

Lpoutbuffer

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

nOutBufferSize

Não usado com esta operação. 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
Windows 8 [somente aplicativos da área de trabalho]
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