structure SET_BAND_METADATA_PARAMETERS (ehstorbandmgmt.h)

Article
02/26/2024

Les métadonnées d’une bande configurée sont définies sur les paramètres d’une structure SET_BAND_METADATA_PARAMETERS . Cette structure est une entrée pour une demande de IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA .

Syntaxe

typedef struct _SET_BAND_METADATA_PARAMETERS {
  ULONG         StructSize;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         MetadataOffset;
  ULONG         MetadataSize;
  ULONG         BufferOffset;
  ULONG         AuthKeyOffset;
} SET_BAND_METADATA_PARAMETERS, *PSET_BAND_METADATA_PARAMETERS;

Membres

StructSize

Taille de cette structure en octets. Défini sur sizeof(SET_BAND_METADATA_PARAMETERS).

BandId

Identificateur d’une seule bande 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 une bande, définissez BandId = (ULONG) –1.

BandStart

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

MetadataOffset

Décalage du début de la propriété de métadonnées de bande pour définir les nouvelles données.

MetadataSize

Longueur des octets de métadonnées à définir. Cette taille est limitée par la valeur de MetadataOffset soustraite du membre BandMetadataSize de la structure BAND_MANAGEMENT_CAPABILITIES .

BufferOffset

Décalage, en octets, du début de SET_BAND_METADATA_PARAMETERS à l’emplacement des nouvelles métadonnées.

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 SET_BAND_METADATA_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 clés.

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

Remarques

La priorité est donné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é dans le bloc IoStatus pour IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA.

Si BandID et BandStart sont tous deux définis sur –1, le IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA définit les métadonnées pour la bande globale.

La taille du magasin de métadonnées de bande se trouve dans le membre BandMetadataSize de BAND_MANAGEMENT_CAPABILITIES. Cette structure est retournée à partir d’une demande de IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES .

Les nouvelles métadonnées à définir pour la bande sont incluses dans la mémoire tampon système pour la demande IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA et suivent cette structure dans BufferOffset.