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
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) |