IOCTL_STORAGE_REINITIALIZE_MEDIA IOCTL (ntddstor.h)
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
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
Guide pratique pour effectuer une IRP dans une routine de distribution