structure DELETE_BAND_PARAMETERS (ehstorbandmgmt.h)

Article
02/06/2025

Une bande configurée est supprimée en fonction des paramètres d’une structure DELETE_BAND_PARAMETERS. Cette structure est une entrée pour une demande de IOCTL_EHSTOR_BANDMGMT_DELETE_BAND.

Syntaxe

typedef struct _DELETE_BAND_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         AuthKeyOffset;
} DELETE_BAND_PARAMETERS, *PDELETE_BAND_PARAMETERS;

Membres

StructSize

Taille de cette structure en octets. Défini sur taille de(DELETE_BAND_PARAMETERS).

Flags

Supprimer les indicateurs d’opération. Cette valeur est une combinaison OR au niveau du bit des éléments suivants.

Valeur	Signification
DELBAND_ERASE_BEFORE_DELETE	Effectuez une effacement de chiffrement des données de propriété de bande avant la suppression.

Reserved

Réservé.

BandId

Identificateur d’une bande unique pour laquelle retourner des informations. BandSize doit être 0 lorsqu’une seule bande est sélectionnée avec BandId. Pour utiliser bandStart et BandSize au lieu de bandId pour sélectionner un groupe, définissez BandId = (ULONG) –1.

BandStart

Emplacement d’octet de départ sur l’appareil de stockage pour commencer une recherche de bande. Une tentative est effectuée pour faire correspondre un groupe au ou après BandStart.

AuthKeyOffset

Décalage, en octets, d’une structure AUTH_KEY contenant la clé d’autorisation pour la bande. Le décalage est du début de DELETE_BAND_PARAMETERS. AUTH_KEY est déclaré dans ehstorbandmgmt.h comme suit.

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

KeySize

Taille de la clé, en octets, des données de clé à clé. Si KeySize a la valeur 0, une clé par défaut est utilisée.

Clé

Tableau d’octets de longueur variable contenant les données clés.

Pour spécifier une clé d’authentification par défaut sur la bande, définissez AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY. Si indicateurs contient DELBAND_ERASE_BEFORE_DELETE, AuthKeyOffset doit être défini sur EHSTOR_BANDMGR_NO_KEY.

Remarques

La priorité est donnée à id de bande pour la sélection de bande. Si BandID est supérieur à 0 et bandID est inférieur au membre MaxBandCount de BAND_MANAGEMENT_CAPABILITIES, BandID est utilisé comme seul critère de sélection pour une correspondance de bande. Si BandID == –1, bandStart est utilisé comme critères de correspondance pour sélectionner une bande. Si aucune bande ne correspond à l’un des critères de sélection, STATUS_INVALID_PARAMETER est retournée dans le bloc IoStatus pour IOCTL_EHSTOR_BANDMGMT_DELETE_BAND.

Si DELBAND_ERASE_BEFORE_DELETE est défini dans indicateurs, une clé d’authentification n’est pas nécessaire pour supprimer la bande. Si cet indicateur n’est pas défini, la clé d’authentification actuelle doit être incluse dans AuthKeyOffset.