SET_BAND_LOCATION_PARAMETERS structure (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 sizeof(SET_BAND_LOCATION_PARAMETERS).
BandId
Identificateur d’une seule bande pour laquelle retourner des informations. BandSize doit être 0 quand 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 des octets sur le périphérique de stockage pour commencer une recherche de bande. Une tentative est effectuée pour faire correspondre un groupe à 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é à 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 spécifier une clé d’autorisation par défaut pour 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 accordé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ée dans le bloc IoStatus pour IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION.
Si BandID et BandStart sont tous deux définis sur –1, la demande de IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION modifie les propriétés de la bande globale.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 8 |
| En-tête | ehstorbandmgmt.h (inclure EhStorBandMgmt.h) |