ENUMERATE_BANDS_PARAMETERS structure (ehstorbandmgmt.h)
La structure ENUMERATE_BANDS_PARAMETERS permet de 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 sizeof(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 membres BandId, BandStart et BandSize sont ignorés. |
|
Incluez des informations sur l’algorithme de chiffrement multimédia dans le membre SecurityInfo de BAND_TABLE_ENTRY. |
Reserved
Réservé.
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.
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 la sélection d’une bande. Sinon, une bande à ou après BandStart et BandSize correspondant 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 seule bande. Une correspondance de bande unique est effectuée en fonction des valeurs dans BandID, BandStart et BandSize. La priorité est accordée à BandID pour la sélection de la bande. Si BandID> 0 et BandID<MaxBandCount membre de BAND_MANAGEMENT_CAPABILITIES 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 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 à l’emplacement BandStart ou après 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 qu’aucune bande n’est configurée et que Indicateurs n’est pas défini sur ENUMBANDS_ENUM_ALL_BANDS, la bande globale de 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 de secteur du périphérique de stockage sous-jacent.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 8 |
| En-tête | ehstorbandmgmt.h (inclure EhStorBandMgmt.h) |