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 |
|