IOCTL_VOLUME_OFFLINE IOCTL (ntddvol.h)
Le IOCTL_VOLUME_OFFLINE IOCTL place le volume dans un état HORS CONNEXION, qui est un état où les opérations de lecture et d’écriture échouent. Les demandes ne seront pas transmises au disque physique tant qu’une IOCTL_VOLUME_ONLINE ultérieure n’est pas reçue.
Une utilisation courante pour IOCTL_VOLUME_OFFLINE est un cas dans lequel une application ou un pilote souhaite empêcher un volume d’être remonté par un appel pour ouvrir le volume à partir d’une deuxième application ou d’un second pilote pendant que le volume est en cours de suppression par la première application ou le premier pilote. Par exemple, avant de masquer un numéro d’unité logique (LUN), les volumes sur la LUN doivent être verrouillés (facultatifs), démontés, mis hors connexion et désinstallés. À présent, la LUN peut être masquée sans que Plug-and-Play événements de suppression surprise (PnP) soient consignés pour les volumes et le disque lui-même. Sans l’appel pour mettre le volume hors connexion, une fois le handle utilisé pour le démonter est fermé, le volume peut être remonté par un appel pour l’ouvrir à partir d’une autre application ou d’un autre pilote, s’il s’est produit avant l’appel de désinstallation du volume. Un appel à l’ouverture d’un volume réussit sur un volume hors connexion, mais les E/S dirigées vers un volume hors connexion échouent. La mise hors connexion d’un volume n’a aucun effet sur les E/S de disque (si l’application ou le pilote a ouvert un handle sur le disque), mais arrête les E/S de volume (si l’application ou le pilote a ouvert un handle sur le volume).
Code principal
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) |