IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL (ehstorbandmgmt.h)

La demande IOCTL_EHSTOR_BANDMGMT_ERASE_BAND efface et réinitialise la clé d’authentification d’une bande par chiffrement. La configuration restante de la bande n’est pas modifiée.

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 un ERASE_BAND_PARAMETERS et éventuellement une structure de AUTH_KEY.

Si le membre NewAuthKeyOffset de ERASE_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(ERASE_BAND_PARAMETERS) + sizeof(AUTH_KEY).

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	La bande a été effacé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 d’effacement n’est pas une clé par défaut et la bande ne peut pas être effacée.
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 d’effacement actuelle n’est pas fournie dans une demande de IOCTL_EHSTOR_BANDMGMT_ERASE_BAND . La clé d’authentification d’effacement du périphérique de stockage est configurée précédemment.

Aucune méthode n’est fournie dans Windows pour modifier la clé d’authentification d’effacement d’un périphérique de stockage. À condition que les paramètres corrects soient fournis en tant qu’entrée dans la mémoire tampon système, cette demande doit réussir. Si la clé d’authentification d’effacement a été modifiée en dehors de Windows, par exemple dans un environnement à double démarrage avec un système d’exploitation différent, cette demande peut échouer.

Lorsqu’une bande est effacée avec IOCTL_EHSTOR_BANDMGMT_ERASE_BAND, les seules propriétés antérieures qui restent sont le début de la bande et la taille de la bande. La clé de chiffrement multimédia précédente est supprimée et une nouvelle clé est générée. Le verrouillage est défini sur PERSISTANT_UNLOCK pour la lecture et l’écriture. Les métadonnées de sécurité précédemment définies sont effacées. La nouvelle clé d’authentification spécifiée dans ERASE_BAND_PARAMETERS est définie, sauf si l’utilisation de la clé par défaut est indiquée.

Pour empêcher d’autres applications de prendre le contrôle d’une bande et d’effacer à l’aide de la clé par défaut, une nouvelle clé d’authentification doit être incluse dans la demande IOCTL_EHSTOR_BANDMGMT_ERASE_BAND .

Les modifications apportées à la table de bandes par cette requête sont validées sur l’appareil de manière atomique avant la fin de la requête IOCTL. Par conséquent, il est garanti que la bande est modifiée avec toutes ses propriétés définies ou aucune propriété définie si un système ou une panne de courant se produit.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
En-tête	ehstorbandmgmt.h (inclure EhStorBandMgmt.h)

Voir aussi

ERASE_BAND_PARAMETERS

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS