GET_BAND_METADATA_PARAMETERS structure (ehstorbandmgmt.h)
Les métadonnées d’une bande configurée sont récupérées en fonction des paramètres d’une structure GET_BAND_METADATA_PARAMETERS . Cette structure est une entrée pour une demande IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA .
Syntaxe
typedef struct _GET_BAND_METADATA_PARAMETERS {
ULONG StructSize;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG MetadataOffset;
ULONG MetadataSize;
} GET_BAND_METADATA_PARAMETERS, *PGET_BAND_METADATA_PARAMETERS;
Membres
StructSize
Taille de cette structure en octets. Définissez sur sizeof(GET_BAND_METADATA_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.
MetadataOffset
Décalage à partir du début de la propriété de métadonnées de bande à partir de laquelle récupérer des données.
MetadataSize
Longueur des octets de métadonnées à récupérer.
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_GET_BAND_METADATA.
Si BandID et BandStart sont tous deux définis sur –1, le IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA retourne les métadonnées pour la bande globale.
Si IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA a réussi, Parameters.DeviceIoControl.InputBufferLength est égal à la valeur dans MetadataSize.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 8 |
| En-tête | ehstorbandmgmt.h (inclure EhStorBandMgmt.h) |