GET_BAND_METADATA_PARAMETERS structure (ehstorbandmgmt.h)

Article
02/29/2024

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)

Voir aussi

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA

Partager via