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

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.

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

Voir aussi

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND