code de contrôle IOCTL_DISK_ARE_VOLUMES_READY

Attend que tous les volumes sur le disque spécifié soient prêts à être utilisés.

Pour effectuer cette opération, appelez la fonction DeviceIoControl avec les paramètres suivants.

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

Paramètres

hDevice

Handle sur le disque.

Pour récupérer un handle d’appareil, appelez la fonction CreateFile .

dwIoControlCode

Code de contrôle pour l’opération.

Utilisez IOCTL_DISK_ARE_VOLUMES_READY pour cette opération.

lpInBuffer

Non utilisé avec cette opération. Définissez sur NULL.

nInBufferSize

Taille de la mémoire tampon d’entrée, en octets. Définissez sur 0 (zéro).

lpOutBuffer

Non utilisé avec cette opération. Définissez sur NULL.

nOutBufferSize

Non utilisé avec cette opération. Définissez sur 0 (zéro).

lpBytesReturned

Non utilisé avec cette opération. Définissez sur NULL.

lpOverlapped

Pointeur vers une structure CHEVAUCHEMENT .

Si hDevice a été ouvert sans spécifier FILE_FLAG_OVERLAPPED, lpOverlapped est ignoré.

Si hDevice a été ouvert avec l’indicateur FILE_FLAG_OVERLAPPED , l’opération est effectuée en tant qu’opération (asynchrone) superposée. Dans ce cas, lpOverlapped doit pointer vers une structure OVERLAPPED valide qui contient un handle vers un objet d’événement. Sinon, la fonction échoue de manière imprévisible.

Pour les opérations qui se chevauchent, DeviceIoControl retourne immédiatement et l’objet d’événement est signalé une fois l’opération terminée. Sinon, la fonction ne retourne pas tant que l’opération n’est pas terminée ou qu’une erreur se produit.

Valeur retournée

Si l’opération se termine correctement, indiquant que tous les volumes sur le disque sont prêts à être utilisés, DeviceIoControl retourne une valeur différente de zéro.

Si l’opération échoue ou est en attente, DeviceIoControl retourne zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
En-tête	Ntdddisk.h

Voir aussi

DeviceIoControl

Codes de contrôle de gestion des disques