IOCTL_EHSTOR_BANDMGMT_REVERT IOCTL (ehstorbandmgmt.h)
Cette demande de IOCTL_EHSTOR_BANDMGMT_REVERT est envoyée pour désactiver les fonctionnalités de sécurité et la gestion de bande sur un appareil de stockage. La demande inclut les options de restauration et la clé d’authentification.
Code principal
Mémoire tampon d’entrée
La mémoire tampon d’entrée à Irp->AssociatedIrp.SystemBuffer contient une structure ACTIVATE_REVERT_PARAMETERS. ACTIVATE_REVERT_PARAMETERS est déclaré dans ehstorbandmgmt.h comme suit.
typedef struct _ACTIVATE_REVERT_PARAMETERS
{
ULONG StructSize;
ULONG Flags;
ULONG AuthKeyOffset;
} ACTIVATE_REVERT_PARAMETERS;
La ACTIVATE_REVERT_PARAMETERS suivante dans la mémoire tampon système est une structure AUTH_KEY. Cela contient les octets de données clés de la clé d’authentification. AUTH_KEY est déclaré dans ehstorbandmgmt.h comme suit.
typedef struct _AUTH_KEY
{
ULONG KeySize;
UCHAR Key[ANYSIZE_ARRAY];
} AUTH_KEY;
Longueur de la mémoire tampon d’entrée
Longueur d’une structure ACTIVATE_REVERT_PARAMETERS.
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 Status.
| Valeur d’état | Description |
|---|---|
| STATUS_SUCCESS | Les fonctionnalités de sécurité sur l’appareil de stockage ont été désactivées. |
| 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 n’est pas valide. |
| 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. La désactivation est refusée. |
| STATUS_DEVICE_CONFIGURATION_ERROR | Le système ne peut pas configurer l’appareil en mode pris en charge. |
| STATUS_IO_DEVICE_ERROR | Échec de la communication. L’appareil de stockage peut être incompatible avec les protocoles de sécurité. |
| STATUS_INVALID_DEVICE_STATE | L’appareil de stockage n’est pas activé. |
Remarques
En cas de retour réussi à partir d’une demande de IOCTL_EHSTOR_BANDMGMT_REVERT, l’appareil de stockage retourne à un état de sécurité inactif et à toutes les IOCTL de gestion de bande, à l’exception des IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES et des IOCTL_EHSTOR_BANDMGMT_ACTIVATE, deviennent indisponibles.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8 |
| d’en-tête | ehstorbandmgmt.h (include EhStorBandMgmt.h) |