IOCTL_EHSTOR_BANDMGMT_REVERT IOCTL (ehstorbandmgmt.h)

Article
08/07/2023

Cette IOCTL_EHSTOR_BANDMGMT_REVERT demande est envoyée pour désactiver les fonctionnalités de sécurité et la gestion des bandes sur un périphérique de stockage. La demande inclut les options de restauration et la clé d’authentification.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

La mémoire tampon d’entrée dans 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. Cette propriété contient les octets de données de clé pour 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 de 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 État .

Valeur d’état	Description
STATUS_SUCCESS	Les fonctionnalités de sécurité sur le périphérique de stockage ont été désactivées.
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 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. Le périphérique de stockage peut être incompatible avec les protocoles de sécurité.
STATUS_INVALID_DEVICE_STATE	Le périphérique de stockage n’est pas activé.

Remarques

À un retour réussi à partir d’une demande de IOCTL_EHSTOR_BANDMGMT_REVERT , le périphérique de stockage retourne à un état de sécurité inactif et tous les IOCTL de gestion des bandes, à l’exception des IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES et des IOCTL_EHSTOR_BANDMGMT_ACTIVATE, deviennent indisponibles.

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

IOCTL_EHSTOR_BANDMGMT_ACTIVATE

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

Partager via