Condividi tramite


IOCTL_DISK_ARE_VOLUMES_READY codice di controllo

Attende che tutti i volumi nel disco specificato siano pronti per l'uso.

Per eseguire questa operazione, chiamare la funzione DeviceIoControl con i parametri seguenti.

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

Parametri

hDevice

Handle per il disco.

Per recuperare un handle di dispositivo, chiamare la funzione CreateFile .

dwIoControlCode

Codice di controllo per l'operazione.

Usare IOCTL_DISK_ARE_VOLUMES_READY per questa operazione.

lpInBuffer

Non usato con questa operazione. Impostare su NULL.

nInBufferSize

Dimensioni del buffer di input, in byte. Impostare su 0 (zero).

lpOutBuffer

Non usato con questa operazione. Impostare su NULL.

nOutBufferSize

Non usato con questa operazione. Impostare su 0 (zero).

lpBytesReturned

Non usato con questa operazione. Impostare su NULL.

lpOverlapped

Puntatore a una struttura OVERLAPPED .

Se hDevice è stato aperto senza specificare FILE_FLAG_OVERLAPPED, lpOverlapped viene ignorato.

Se hDevice è stato aperto con il flag FILE_FLAG_OVERLAPPED , l'operazione viene eseguita come operazione sovrapposta (asincrona). In questo caso , lpOverlapped deve puntare a una struttura OVERLAPPED valida che contiene un handle a un oggetto evento. In caso contrario, la funzione ha esito negativo in modi imprevedibili.

Per le operazioni sovrapposte, DeviceIoControl restituisce immediatamente e l'oggetto evento viene segnalato al termine dell'operazione. In caso contrario, la funzione non restituisce finché l'operazione non è stata completata o si verifica un errore.

Valore restituito

Se l'operazione viene completata correttamente, a indicare che tutti i volumi sul disco sono pronti per l'uso, DeviceIoControl restituisce un valore diverso da zero.

Se l'operazione ha esito negativo o è in sospeso, DeviceIoControl restituisce zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Requisiti

Requisito Valore
Client minimo supportato
Windows 8 [solo app desktop]
Server minimo supportato
Windows Server 2012 [solo app desktop]
Intestazione
Ntdddisk.h

Vedi anche

Deviceiocontrol

Codici di controllo di gestione dei dischi