CREATE_BAND_PARAMETERS structure (ehstorbandmgmt.h)

Article
02/26/2024

Les paramètres permettant de créer une bande sur un périphérique de stockage pour une demande de IOCTL_EHSTOR_BANDMGMT_CREATE_BAND sont spécifiés dans une structure de 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 sizeof(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 de 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 la bande ne sont pas présentes, les métadonnées du gestionnaire de clés pour la bande sont définies sur tous les zéros. En outre, lorsque ce membre a la valeur 0, les états de verrouillage de lecture et d’écriture sont PERSISTANT_UNLOCK par défaut.

AuthKeyOffset

Décalage, en octets, d’une structure de 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é à 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 affecter une clé d’autorisation par défaut à la bande, définissez AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.

Remarques

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