Share via

IOCTL_DISK_RESET_SNAPSHOT_INFO IOCTL (ntdddisk.h)

  • Article

Efface toutes les informations de instantané matérielles du service vsS du disque. Un instantané est également appelé cliché instantané. Cette demande est disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows. L’appelant doit s’exécuter sur IRQL = PASSIVE_LEVEL.

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 Information est défini sur zéro. Le membre Status est défini sur STATUS_SUCCESS si l’opération a réussi. Sinon, le membre Status est défini sur le code d’erreur approprié.

Remarques

Ce code de contrôle d’E/S peut être émis à partir d’un pilote en mode noyau ou d’une application en mode utilisateur. Lorsque ce code de contrôle d’E/S est émis à partir d’un pilote en mode noyau, l’appelant fournit un paquet de demandes d’E/S (IRP) qui contient une structure de données IO_STATUS_BLOCK. Cette structure de données est utilisée pour retourner des informations d’erreur à l’appelant. Lorsque ce code de contrôle d’E/S est émis à partir d’une application en mode utilisateur avec la routine DeviceIocontrol , l’appelant peut obtenir des informations d’erreur en appelant la routine GetLastError .

Le disque dont le handle est utilisé lors de l’émission de ce IOCTL peut être dans l’état hors connexion lors de l’émission de l’IOCTL. Si le disque est mis à l’état hors connexion à l’aide du composant logiciel enfichable Microsoft Management Console (MMC) gestionnaire de disques, son attribut en lecture seule est défini sur le disque, ce qui entraîne l’échec de cet IOCTL. Toutefois, si l’utilitaire de partition de disque (Diskpart.exe) est utilisé pour placer le disque dans l’état hors connexion, l’attribut en lecture seule du disque n’est pas défini. Pour cette raison, il est préférable d’utiliser l’utilitaire de partition de disque pour placer un disque dans l’état hors connexion.

Note Un effet secondaire de l’utilisation de ce IOCTL est que les outils de gestion des disques peuvent signaler une partition supplémentaire de type « UNKNOWN » sur les disques GPT. Cette partition de 256 kilo-octets est créée par l’opération IOCTL et est une partition instantané utilisée dans le processus de restauration. Cette partition est attendue et peut être ignorée par les administrateurs système.
 

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows Vista.
En-tête ntdddisk.h (incluez Ntdddisk.h)
IRQL PASSIVE_LEVEL