Partager via

IOCTL_DISK_RESET_SNAPSHOT_INFO IOCTL (ntdddisk.h)

  • Article

Efface toutes les informations de capture instantanée matérielle du service VSS (Volume Shadow Copy Service) à partir du disque. Un instantané est également appelé cliché instantané. Cette demande est disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. L’appelant doit s’exécuter à 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é lorsque cette IOCTL est émise peut être dans l’état hors connexion lorsque le IOCTL est émis. Si le disque est placé dans l’état hors connexion à l’aide du composant logiciel enfichable Microsoft Management Console (MMC) du gestionnaire de disques, le disque aura son jeu d’attributs en lecture seule, ce qui entraînera l’échec de cette durée de vie 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 pour le 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.

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

Exigences

Exigence Valeur
client minimum pris en charge Disponible à partir de Windows Vista.
d’en-tête ntdddisk.h (include Ntdddisk.h)
IRQL PASSIVE_LEVEL