structure SET_BAND_LOCATION_PARAMETERS (ehstorbandmgmt.h)
La structure SET_BAND_LOCATION_PARAMETERS spécifie les paramètres permettant de définir les propriétés d’emplacement d’une bande sur un périphérique de stockage pour une demande de IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION.
Syntaxe
typedef struct _SET_BAND_LOCATION_PARAMETERS {
ULONG StructSize;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG AuthKeyOffset;
ULONG BandLocationInfoOffset;
} SET_BAND_LOCATION_PARAMETERS, *PSET_BAND_LOCATION_PARAMETERS;
Membres
StructSize
Taille de cette structure en octets. Défini sur taille de(SET_BAND_LOCATION_PARAMETERS).
BandId
Identificateur d’une bande unique 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 un groupe, définissez BandId = (ULONG) –1.
BandStart
Emplacement d’octet de départ sur l’appareil de stockage pour commencer une recherche de bande. Une tentative est effectuée pour faire correspondre un groupe au ou après BandStart.
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_LOCATION_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 spécifier une clé d’autorisation par défaut sur la bande, définissez AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.
BandLocationInfoOffset
Décalage, en octets, d’une structure BAND_LOCATION_INFO. Le décalage est du début de SET_BAND_LOCATION_PARAMETERS.
Remarques
La priorité est donnée à id de bande pour la sélection de bande. Si BandID est supérieur à 0 et 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ères de correspondance pour sélectionner une bande. Si aucune bande ne correspond à l’un des critères de sélection, STATUS_INVALID_PARAMETER est retournée dans le bloc IoStatus pour IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION.
Si bandID et bandStart sont tous les deux définis sur –1, la demande de IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION modifie les propriétés de la bande globale.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8 |
| d’en-tête | ehstorbandmgmt.h (include EhStorBandMgmt.h) |