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 l’appareil 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érieure, Parameters.DeviceIoControl.InputBufferLeng th indique la taille, en octets, de la mémoire tampon de paramètres à 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 l’appareil de stockage. Il n’existe aucune garantie quant à la réussite de la suppression ou de la récupération des données de l’appareil de stockage une fois la commande terminée.
Ce IOCTL est limité aux disques de données sur les appareils de la famille d’appareils de bureau. Dans Windows Preinstallation Environment (WinPE), cette IOCTL est prise 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 l’état.
Les appelants doivent d’abord appeler FSCTL_LOCK_VOLUME avant d’appeler cette IOCTL pour vider les données mises en cache dans les couches supérieures. Aucune attente de l’achèvement de la demande en attente n’est effectuée avant d’émettre la commande sur l’appareil.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10, version 1607 |
| serveur minimum pris en charge | Windows Server 2016 |
| d’en-tête | ntddstor.h |