GET_BAND_METADATA_PARAMETERS Struktur (ehstorbandmgmt.h)

Die Metadaten für ein konfiguriertes Band werden gemäß den Parametern in einer GET_BAND_METADATA_PARAMETERS Struktur abgerufen. Diese Struktur wird für eine IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA Anforderung eingegeben.

Syntax

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;

Angehörige

StructSize

Die Größe dieser Struktur in Byte. Auf Größe(GET_BAND_METADATA_PARAMETERS) festgelegt.

BandId

Der Bezeichner eines einzelnen Bandes, für den Informationen zurückgegeben werden sollen. BandSize- muss 0 sein, wenn ein einzelnes Band mit BandId ausgewählt wird. Um BandStart- und BandSize anstelle BandId- zum Auswählen eines Bandes zu verwenden, legen Sie BandId = (ULONG) –1 fest.

BandStart

Der Startbytespeicherort auf dem Speichergerät, um eine Bandsuche zu starten. Es wird versucht, ein Band an oder nach BandStart-abzugleichen.

MetadataOffset

Der Offset vom Anfang der Bandmetadateneigenschaft zum Abrufen von Daten aus.

MetadataSize

Die Länge der abzurufenden Metadatenbytes.

Bemerkungen

Rangfolge wird BandID- für die Bandauswahl zugewiesen. Wenn BandID- größer als 0 ist und BandID- kleiner als das MaxBandCount Mitglied von BAND_MANAGEMENT_CAPABILITIESist, wird BandID- als einzige Auswahlkriterien für eine Band-Übereinstimmung verwendet. Wenn BandID == –1, wird BandStart- als Übereinstimmungskriterien zum Auswählen eines Bandes verwendet. Wenn kein Band mit beiden Auswahlkriterien übereinstimmt, wird STATUS_INVALID_PARAMETER im IoStatus--Block für IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATAzurückgegeben.

Wenn BandID und BandStart- auf –1 festgelegt sind, gibt die IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA Metadaten für das globale Band zurück.

Wenn IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA erfolgreich war, entspricht Parameters.DeviceIoControl.InputBufferLength dem Wert in MetadataSize.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows 8
Header-	ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h)

Siehe auch

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA