IOCTL_EHSTOR_BANDMGMT_DELETE_BAND IOCTL (ehstorbandmgmt.h)
Une bande configurée sur un appareil de stockage est supprimée avec la demande 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 la bande.
Code principal
Mémoire tampon d'entrée
La mémoire tampon d’entrée sur Irp-AssociatedIrp.SystemBuffer> doit contenir une structure DELETE_BAND_PARAMETERS et éventuellement une structure AUTH_KEY.
Si le membre AuthKeyOffset 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 État .
| Valeur d’état | Description |
|---|---|
| STATUS_SUCCESS | La bande a été supprimée avec succès. |
| STATUS_INVALID_DEVICE_REQUEST | Le périphérique 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. Le périphérique de stockage peut être incompatible avec les protocoles de sécurité. |
Remarques
Une clé d’authentification est requise pour supprimer une bande sans effectuer d’effacer au préalable. Pour demander une suppression de bande, l’indicateur DELBAND_ERASE_BEFORE_DELETE est défini dans le membre Indicateurs de DELETE_BAND_PARAMETERS.
Après une suppression de bande, tous les LBA contenus dans la bande supprimée sont retournés à la bande globale. Les conditions de verrouillage de la bande globale s’appliquent désormais aux LBA retournés à la bande globale. Les LBA retournés à la bande globale sont désormais associés à la clé multimédia pour la bande globale et les données chiffrées dans ces LBA sont irrécupérables.
La bande supprimée reste dans la table de bande du pilote de silo, mais n’est pas 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 verrou reviennent à PERSISTENT_UNLOCK. La bande est désormais disponible pour une 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 de 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 depuis la suppression de la bande précédente seront disponibles. Pour éviter cette situation, supprimez la bande avec l’indicateur DELBAND_ERASE_BEFORE_DELETE défini dans DELETE_BAND_PARAMETERS.
Le IOCTL_EHSTOR_BANDMGMT_DELETE_BAND ne supprime pas la bande globale. Une demande de le faire retourne STATUS_INVALID_PARAMETER.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 8. |
| En-tête | ehstorbandmgmt.h (inclure EhStorBandMgmt.h) |