_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
NTDDDISK. h

Voir aussi

DeviceIoControl

Codes de contrôle de gestion des disques

_informations sur le cluster de disque _

_informations de _ cluster d’extraction de disque IOCTL _ _