code de contrôle IOCTL_DISK_SET_CLUSTER_INFO
Définit les informations de cluster sur un disque.
Pour effectuer cette opération, appelez la fonction DeviceIoControl avec les paramètres suivants.
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
Paramètres
-
hDevice
-
Handle sur le disque.
Pour récupérer un handle d’appareil, appelez la fonction CreateFile .
-
dwIoControlCode
-
Code de contrôle de l’opération.
Utilisez IOCTL_DISK_SET_CLUSTER_INFO pour cette opération.
-
lpInBuffer
-
Pointeur vers une structure de données DISK_CLUSTER_INFO qui contient des informations de cluster pour le disque.
-
nInBufferSize
-
Taille de la mémoire tampon d’entrée, en octets.
-
lpOutBuffer
-
Non utilisé avec cette opération. Définissez sur NULL.
-
nOutBufferSize
-
Taille de la mémoire tampon de sortie en octets. Défini 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 superposée (asynchrone). Dans ce cas, lpOverlapped doit pointer vers une structure CHEVAUCHEMENT 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 ne se produit pas.
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 |
Aucun pris en charge |
| Serveur minimal pris en charge |
Windows Server 2012 [applications de bureau uniquement] |
| En-tête |
|