IOCTL_EHSTOR_BANDMGMT_DELETE_BAND IOCTL (ehstorbandmgmt.h)
Une bande configurée sur un appareil de stockage est supprimée avec la demande de IOCTL_EHSTOR_BANDMGMT_DELETE_BAND. Une option d’effacement dans les paramètres d’entrée permet à la demande d’effectuer une effacement de chiffrement des données de bande.
Code principal
Mémoire tampon d’entrée
La mémoire tampon d’entrée à >AssociatedIrp.SystemBuffer doit contenir un DELETE_BAND_PARAMETERS et éventuellement une structure AUTH_KEY.
Si le AuthKeyOffset membre de DELETE_BAND_PARAMETERS est défini sur EHSTOR_BANDMGR_NO_KEY, les données d’entrée dans la mémoire tampon système n’ont pas besoin d’inclure une structure AUTH_KEY.
Longueur de la mémoire tampon d’entrée
Parameters.DeviceIoControl.InputBufferLength indique la taille, en octets, de la mémoire tampon, qui doit être au moins sizeof (DELETE_BAND_PARAMETERS) + sizeof(AUTH_KEY).
Mémoire tampon de sortie
Aucun.
Longueur de la mémoire tampon de sortie
Aucun.
Bloc d’état
L’une des valeurs suivantes peut être retournée dans le champ Status.
| Valeur d’état | Description |
|---|---|
| STATUS_SUCCESS | La bande a été supprimée avec succès. |
| STATUS_INVALID_DEVICE_REQUEST | L’appareil de stockage ne prend pas en charge la gestion des bandes. |
| STATUS_INVALID_BUFFER_SIZE | La taille de la mémoire tampon d’entrée est incorrecte. |
| STATUS_INVALID_PARAMETER | Les informations contenues dans la mémoire tampon d’entrée ne sont pas valides. |
| STATUS_ACCESS_DENIED | La clé d’authentification n’est pas valide ou la bande est verrouillée pour l’écriture. |
| STATUS_NOT_FOUND | La bande n’a pas été trouvée pour les critères de sélection fournis. |
| STATUS_IO_DEVICE_ERROR | Échec de la communication. L’appareil de stockage peut être incompatible avec les protocoles de sécurité. |
Remarques
Une clé d’authentification est nécessaire pour supprimer une bande sans effectuer d’effacement en premier. Pour demander une effacement de bande, l’indicateur DELBAND_ERASE_BEFORE_DELETE est défini dans les indicateurs membre de DELETE_BAND_PARAMETERS.
Après la suppression d’une bande, toutes les LBA contenues dans la bande supprimée sont retournées à la bande globale. Les conditions de verrouillage de la bande globale s’appliquent désormais aux LBA retournées à la bande globale. Les LBA retournées à la bande globale sont désormais associées à la clé multimédia de la bande globale et les données chiffrées dans ces LBA ne sont pas récupérables.
La bande supprimée reste dans la table de bande du pilote de silo, mais devient non configurée. La clé d’authentification est réinitialisée à la valeur par défaut, la bande et les métadonnées de clé contiennent des zéros, et les états de verrouillage reviennent à PERSISTENT_UNLOCK. La bande est désormais disponible pour la reconfiguration avec une demande de IOCTL_EHSTOR_BANDMGMT_CREATE_BAND.
La suppression d’une bande sans effacement de chiffrement ne supprime pas la clé de chiffrement pour cette bande. Il est possible de créer ultérieurement une bande avec la même configuration et le même identificateur de bande que la bande supprimée. Dans ce cas, les données précédemment stockées dans la bande et non remplacées, car la suppression de la bande précédente sera disponible. Pour éviter cette situation, supprimez la bande avec l’indicateur de DELBAND_ERASE_BEFORE_DELETE défini dans DELETE_BAND_PARAMETERS.
La IOCTL_EHSTOR_BANDMGMT_DELETE_BAND ne supprime pas la bande globale. Une demande à ce faire retourne STATUS_INVALID_PARAMETER.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8. |
| d’en-tête | ehstorbandmgmt.h (include EhStorBandMgmt.h) |