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

IRP_MJ_DEVICE_CONTROL

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)

Voir aussi

DELETE_BAND_PARAMETERS

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND