Partager via

IOCTL_STORAGE_REINITIALIZE_MEDIA IOCTL (ntddstor.h)

  • Article

Un pilote peut émettre un code de contrôle IOCTL_STORAGE_REINITIALIZE_MEDIA pour décharger le processus d’effacement sur le périphérique de stockage.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

Pour Windows Server 2022 et versions ultérieures, contient une structure STORAGE_REINITIALIZE_MEDIA facultative avec des options d’assainissement ou NULL. Pour les versions antérieures du système d’exploitation, la mémoire tampon d’entrée est NULL.

Longueur de la mémoire tampon d’entrée

Pour Windows 10 version 21H1 et ultérieures, Parameters.DeviceIoControl.InputBufferLength indique la taille, en octets, de la mémoire tampon de paramètres dans Irp-AssociatedIrp.SystemBuffer>, qui doit être >= sizeof(STORAGE_REINITIALIZE_MEDIA) si Parameters.DeviceIoControl.InputBuffer != NULL ; sinon, zéro. Pour les versions antérieures du système d’exploitation, la longueur de la mémoire tampon d’entrée est égale à zéro.

Mémoire tampon de sortie

Aucun.

Longueur de la mémoire tampon de sortie

Aucun.

Mémoire tampon d’entrée/sortie

n/a

Longueur de la mémoire tampon d’entrée/sortie

n/a

Bloc d’état

Le champ Informations est défini sur zéro si l’appel se termine correctement ; sinon, elle est définie sur une valeur différente de zéro.

Remarques

IOCTL_STORAGE_REINITIALIZE_MEDIA décharge l’effacement sur le périphérique de stockage. Il n’existe aucune garantie quant à la réussite de la suppression ou de la récupération des données du périphérique de stockage une fois la commande terminée.

Cet IOCTL est limité aux disques de données sur les appareils de la famille d’appareils de bureau. Dans l’environnement de préinstallation Windows (WinPE), cet IOCTL est pris en charge pour les disques de démarrage et de données.

Dans les versions antérieures du système d’exploitation, l’implémentation ne nécessite aucune entrée et ne retourne aucune sortie autre que status.

Les appelants doivent d’abord appeler FSCTL_LOCK_VOLUME avant d’appeler ce IOCTL pour vider les données mises en cache dans les couches supérieures. Aucune attente d’achèvement de la requête en attente n’est effectuée avant d’émettre la commande sur l’appareil.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1607
Serveur minimal pris en charge Windows Server 2016
En-tête ntddstor.h

Voir aussi

IO_STATUS_BLOCK structure

STORAGE_REINITIALIZE_MEDIA

Guide pratique pour effectuer une IRP dans une routine de distribution