Partager via


IOCTL_VOLUME_ONLINE IOCTL (ntddvol.h)

La IOCTL_VOLUME_ONLINE IOCTL place le volume dans un état ONLINE, qui est un état où les opérations de lecture et d’écriture sont exécutées. Les demandes sont transmises au disque physique jusqu’à ce qu’une IOCTL_VOLUME_OFFLINE suivante soit reçue.

Une utilisation courante de IOCTL_VOLUME_ONLINE est un cas dans lequel le gestionnaire de montage place automatiquement un nouveau volume dans l’état ONLINE lorsque le volume arrive, sauf si ce volume est répertorié dans une clé de Registre qui est remplie par le service de cluster. IOCTL_VOLUME_ONLINE est appelé pour les lecteurs amovibles, quel que soit le paramètre NoAutoMount dans la clé de Registre suivante :

HKCU\System\CurrentControlSet\Services\Mountmgr\NoAutoMount

Toutefois, pour les volumes contrôlés par NoAutoMount, l’affectation d’une lettre de lecteur entraîne l’appel de IOCTL_VOLUME_ONLINE .

Pour les volumes contrôlés par le service de cluster, IOCTL_VOLUME_ONLINE est envoyé par le service de cluster lorsque le nœud local est propriétaire du volume. Le service de cluster utilise à la fois IOCTL_VOLUME_ONLINE et IOCTL_VOLUME_ONLINE pour autoriser les E/S sur un volume de disque lorsque le volume de disque appartient au serveur local. Tant que le service de cluster n’a pas mis le volume de disque dans un état ONLINE, aucune E/S n’est autorisée pour le volume de disque. Cela empêche l’altération du volume de disque qui pourrait résulter de l’écriture simultanée de plusieurs nœuds de cluster sur le même volume de disque.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

Aucun.

Longueur de la mémoire tampon d’entrée

Aucun.

Mémoire tampon de sortie

Aucun.

Longueur de la mémoire tampon de sortie

Aucun.

Bloc d’état

Le membre Status est défini sur STATUS_SUCCESS.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows XP.
En-tête ntddvol.h (inclure Ntddvol.h)

Voir aussi

IOCTL_VOLUME_OFFLINE