Partager via


IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL (ehstorbandmgmt.h)

La IOCTL_EHSTOR_BANDMGMT_ERASE_BAND demande par chiffrement efface et réinitialise la clé d’authentification d’une bande. 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 à Irp->AssociatedIrp.SystemBuffer doit contenir un ERASE_BAND_PARAMETERS et éventuellement une structure de AUTH_KEY.

Si le NewAuthKeyOffset membre 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 Status.

Valeur d’état Description
STATUS_SUCCESS Le groupe a été effacé 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 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. L’appareil 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 de l’appareil de stockage est précédemment configurée.

Aucune méthode n’est fournie dans Windows pour modifier la clé d’authentification d’effacement d’un appareil de stockage. À condition que les paramètres corrects soient fournis en tant qu’entrée dans la mémoire tampon système, cette requête doit réussir. Si la clé d’authentification d’effacement a été modifiée en dehors de Windows, par exemple dans un environnement de double démarrage avec un autre système d’exploitation, cette requête 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 bande et la taille de 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 de IOCTL_EHSTOR_BANDMGMT_ERASE_BAND.

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

Exigences

Exigence Valeur
client minimum pris en charge Windows 8
d’en-tête ehstorbandmgmt.h (include EhStorBandMgmt.h)

Voir aussi

ERASE_BAND_PARAMETERS

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS