IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS IOCTL (ehstorbandmgmt.h)
La demande IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS efface et réinitialise les clés d’authentification pour toutes les bandes configurées.
Code principal
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.
Mémoire tampon d’entrée/sortie
Aucun.
Longueur de la mémoire tampon d’entrée/sortie
Aucun.
Bloc d’état
L’une des valeurs suivantes peut être retournée dans le champ État .
| Valeur d’état | Description |
|---|---|
| STATUS_SUCCESS | Toutes les bandes ont été effacées avec succès. |
| STATUS_INVALID_DEVICE_REQUEST | Le périphérique de stockage ne prend pas en charge la gestion des bandes. |
| STATUS_IO_DEVICE_ERROR | Échec de la communication. Le périphérique de stockage peut être incompatible avec les protocoles de sécurité. |
Remarques
IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS efface et réinitialise par chiffrement la clé d’authentification pour chaque bande configurée sur le périphérique de stockage, une bande à la fois. Si toutes les bandes configurées sont correctement effacées, IOCTL retourne une status réussie. Si l’effacement échoue pour une ou plusieurs bandes configurées, l’IOCTL retourne l’échec status de la première bande configurée pour laquelle une erreur s’est produite. Dans ce cas, un client doit revenir à l’appel de IOCTL_EHSTOR_BANDMGMT_ERASE_BAND pour chaque bande configurée.
Aucune garantie d’atomicité n’est fournie pour l’effacement sur plusieurs bandes configurées. Ainsi, si un système ou une panne d’alimentation se produit pendant le traitement de ce IOCTL, certaines bandes configurées peuvent avoir été effacées avec succès, tandis que d’autres ne l’ont peut-être pas.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 11, version 22H2 |
| En-tête | ehstorbandmgmt.h |