structure CREATE_BAND_PARAMETERS (ehstorbandmgmt.h)

Article
02/06/2025

Les paramètres permettant de créer une bande sur un appareil de stockage pour une requête IOCTL_EHSTOR_BANDMGMT_CREATE_BAND sont spécifiés dans une structure CREATE_BAND_PARAMETERS.

Syntaxe

typedef struct _CREATE_BAND_PARAMETERS {
  ULONG StructSize;
  ULONG Flags;
  ULONG BandLocationInfoOffset;
  ULONG BandSecurityInfoOffset;
  ULONG AuthKeyOffset;
} CREATE_BAND_PARAMETERS, *PCREATE_BAND_PARAMETERS;

Membres

StructSize

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

Flags

Indicateurs de création de bande. Cette valeur est une combinaison OR au niveau du bit des éléments suivants.

Valeur	Signification
CREATEBAND_AUTHKEY_CACHING_ENABLED	La clé d’authentification pour cette bande est mise en cache, ce qui permet l’automatisation des opérations ultérieures. La clé d’authentification est mise en cache lorsque cet indicateur est défini et que la bande n’est pas verrouillée pour la lecture et l’écriture.

BandLocationInfoOffset

Décalage, en octets, d’une structure BAND_LOCATION_INFO. Le décalage est du début de CREATE_BAND_PARAMETERS.

BandSecurityInfoOffset

Décalage, en octets, d’une structure BAND_SECURITY_INFO. Le décalage est du début de CREATE_BAND_PARAMETERS. Si cette valeur est 0, ce qui signifie que les informations de sécurité de bande ne sont pas présentes, les métadonnées du gestionnaire de clés pour la bande sont définies sur toutes les zéros. En outre, lorsque ce membre est 0, les états de verrou de lecture et d’écriture par défaut sont PERSISTANT_UNLOCK.

AuthKeyOffset

Décalage, en octets, d’une structure AUTH_KEY qui contient la clé d’autorisation pour la nouvelle bande. Le décalage est du début de CREATE_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 qui contient les données clés.

Pour affecter une clé d’autorisation par défaut à la bande, définissez AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.

Remarques

Les CryptoAlgoIdType et CryptoAlgoOidString membres de la structure BAND_SECURITY_INFO à BandSecurityInfoOffset ne sont pas utilisés dans une demande de création de bande et doivent être définis sur 0.