ENUMERATE_BANDS_PARAMETERS structure (ehstorbandmgmt.h)

Article
08/07/2023

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
ENUMBANDS_ENUM_ALL_BANDS	Toutes les bandes sont retournées. Lorsque cet indicateur est défini, les membres BandId, BandStart et BandSize sont ignorés.
ENUMBANDS_REPORT_CRYPTO_ALGO	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.