ERASE_BAND_PARAMETERS structure (ehstorbandmgmt.h)

Article
02/26/2024

La structure ERASE_BAND_PARAMETERS contient les critères de sélection d’une bande à effacer. En outre, une nouvelle clé d’authentification peut être définie. Cette structure est une entrée pour une demande IOCTL_EHSTOR_BANDMGMT_ERASE_BAND .

Syntaxe

typedef struct _ERASE_BAND_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         NewAuthKeyOffset;
} ERASE_BAND_PARAMETERS, *PERASE_BAND_PARAMETERS;

Membres

StructSize

Taille de cette structure en octets. Défini sur sizeof(ERASE_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
ERASEBAND_AUTHKEY_CACHING_ENABLED	La nouvelle clé d’authentification pour cette bande est mise en cache, ce qui permet l’automatisation des opérations ultérieures.

Reserved

Réservé.

BandId

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

BandStart

Emplacement de début des octets sur le périphérique de stockage pour commencer une recherche de bande. Une tentative est effectuée pour faire correspondre un groupe à ou après BandStart.

NewAuthKeyOffset

Décalage, en octets, d’une structure de AUTH_KEY contenant la nouvelle clé d’autorisation pour la bande. Le décalage est du début de ERASE_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é à la clé. Si KeySize a la valeur 0, une clé par défaut est utilisée.

Clé :

Tableau d’octets de longueur variable qui contient les données de clé.

Pour spécifier une clé d’authentification par défaut pour la bande, définissez NewAuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.

Remarques

La priorité est accordée à BandID pour la sélection de la bande. Si BandID est supérieur à 0 et Que 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ère de correspondance pour sélectionner une bande. Si aucune bande ne correspond à l’un ou l’autre des critères de sélection, STATUS_INVALID_PARAMETER est retournée dans le bloc IoStatus pour IOCTL_EHSTOR_BANDMGMT_ERASE_BAND.

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

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND

Partager via