_Code de _ contrôle d' _ informations de cluster IOCTL Disk Set _
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 les _ _ informations du _ cluster _ d’ensemble de disques IOCTL pour cette opération.
-
lpInBuffer
-
Pointeur vers une structure de données d' _ _ informations de cluster de disque 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. Affectez la valeur 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. Affectez la valeur null.
-
lpOverlapped
-
Pointeur vers une structure OVERLAPPED .
Si hDevice a été ouvert sans spécifier d' indicateur de fichier avec _ _ chevauchement, lpOverlapped est ignoré.
Si hDevice a été ouvert avec l’indicateur de fichier avec l' indicateur de _ _ chevauchement , l’opération est exécutée en tant qu’opération Overlapped (asynchrone). Dans ce cas, lpOverlapped doit pointer vers une structure OVERLAPPED valide qui contient un handle vers un objet d’événement. Dans le cas contraire, la fonction échoue de façon imprévisible.
Pour les opérations avec chevauchement, DeviceIoControl retourne immédiatement, et l’objet d’événement est signalé lorsque l’opération est terminée. Sinon, la fonction ne retourne pas jusqu’à ce que l’opération soit terminée ou qu’une erreur se produise.
Valeur retournée
Si l’opération se termine correctement, ce qui indique 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 la valeur zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Configuration requise
| 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 |
|