Partager via

IOCTL_VOLUME_OFFLINE IOCTL (ntddvol.h)

  • Article

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

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_ONLINE