structure SET_BAND_METADATA_PARAMETERS (ehstorbandmgmt.h)
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 8 |
| En-tête | ehstorbandmgmt.h (inclure EhStorBandMgmt.h) |