structure ENUMERATE_BANDS_PARAMETERS (ehstorbandmgmt.h)
La structure ENUMERATE_BANDS_PARAMETERS est utilisée pour sélectionner les entrées d’informations de bande sélectionnées pour le retour à partir d’une demande de IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS.
Syntaxe
typedef struct _ENUMERATE_BANDS_PARAMETERS {
ULONG StructSize;
ULONG Flags;
ULONG Reserved;
ULONG BandId;
LARGE_INTEGER BandStart;
LARGE_INTEGER BandSize;
} ENUMERATE_BANDS_PARAMETERS, *PENUMERATE_BANDS_PARAMETERS;
Membres
StructSize
Taille de cette structure en octets. Défini sur taille de(ENUMERATE_BANDS_PARAMETERS).
Flags
Indicateurs d’énumération de bande. Cette valeur est une combinaison OR au niveau du bit des éléments suivants.
| Valeur | Signification |
|---|---|
|
Toutes les bandes sont retournées. Lorsque cet indicateur est défini, les BandId, bandStartet bandSize membres sont ignorés. |
|
Incluez les informations relatives à l’algorithme de chiffrement multimédia dans le membre SecurityInfo de BAND_TABLE_ENTRY. |
Reserved
Réservé.
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.
BandSize
Valeur de correspondance de taille de bande facultative en octets. Si BandSize == 0 et BandId == –1, BandStart est la seule valeur de correspondance pour sélectionner une bande. Sinon, un groupe à ou après BandStart et la correspondance BandSize exactement est sélectionnée.
Remarques
Lorsque ENUMBANDS_ENUM_ALL_BANDS n’est pas défini dans indicateurs, une tentative de sélection est effectuée pour correspondre à une bande unique. Une correspondance à bande unique est effectuée en fonction des valeurs dans BandID, BandStartet BandSize. La priorité est donnée à id de bande pour la sélection de bande. Si BandID> 0 et BandID<membre maxBandCount de BAND_MANAGEMENT_CAPABILITIES If 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 et BandSize sont utilisés comme critères de correspondance pour sélectionner une bande.
Lorsque bandStart et bandSize sont utilisés pour faire correspondre une bande, la première bande configurée à ou après l’emplacement BandStart ayant la taille exacte de BandSize est retournée. Si BandSize == 0, lorsque bandStart est valide, la première bande configurée à ou après BandStart est retournée.
Si BandID == 0 ou aucune bande n’est configurée et que indicateurs n’est pas défini sur ENUMBANDS_ENUM_ALL_BANDS, la bande globale pour l’ensemble de l’appareil est retournée.
BandStart et BandSize ne sont pas valides, sauf si leurs valeurs, en octets, sont des multiples exacts de la taille du secteur de l’appareil de stockage sous-jacent.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8 |
| d’en-tête | ehstorbandmgmt.h (include EhStorBandMgmt.h) |