IOCTL_VOLUME_OFFLINE IOCTL (ntddvol.h)
La IOCTL_VOLUME_OFFLINE IOCTL place le volume dans un état OFFLINE, 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 le montage d’un volume par un appel pour ouvrir le volume à partir d’une deuxième application ou d’un 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 de l’unité logique doivent être verrouillés (facultatif), démontés, mis hors connexion et désinstallés. À présent, le numéro d’unité logique peut être masqué sans provoquer l’enregistrement des événements de suppression surprise de Plug-and-Play (PnP) 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, le volume peut ensuite être remonté par un appel pour l’ouvrir à partir d’une autre application ou pilote, s’il s’est produit avant l’appel pour désinstaller le volume. Un appel pour ouvrir 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows XP. |
| d’en-tête | ntddvol.h (include Ntddvol.h) |