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 ist eine Eingabe für eine IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA Anforderung.
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;
Member
StructSize
Die Größe dieser Struktur in Bytes. Legen Sie auf sizeof(GET_BAND_METADATA_PARAMETERS) fest.
BandId
Der Bezeichner eines einzelnen Bandes, für das Informationen zurückgegeben werden sollen. BandSize muss 0 sein, wenn ein einzelnes Band mit BandId ausgewählt ist. Wenn Sie BandStart und BandSize anstelle von BandId verwenden möchten, um ein Band auszuwählen, legen Sie BandId = (ULONG) –1 fest.
BandStart
Der Startbytespeicherort auf dem Speichergerät, um eine Bandsuche zu starten. Es wird versucht, eine Band bei oder nach BandStart zuzuordnen.
MetadataOffset
Der Offset vom Anfang der Eigenschaft "Bandmetadaten", aus der Daten abgerufen werden sollen.
MetadataSize
Die Länge der abzurufenden Metadatenbytes.
Hinweise
Die BandID für die Bandauswahl hat Vorrang. Wenn BandID größer als 0 und BandID kleiner als das MaxBandCount-Mitglied von BAND_MANAGEMENT_CAPABILITIES ist, wird BandID als einziges Auswahlkriterium für eine Band-Übereinstimmung verwendet. Wenn BandID == –1, wird BandStart als Übereinstimmungskriterien verwendet, um eine Band auszuwählen. Wenn kein Band mit beiden Auswahlkriterien übereinstimmt, wird STATUS_INVALID_PARAMETER im IoStatus-Block für IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA zurückgegeben.
Wenn BandID und BandStart beide auf –1 festgelegt sind, gibt der 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8 |
| Kopfzeile | ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h) |