SET_BAND_METADATA_PARAMETERS Struktur (ehstorbandmgmt.h)
Die Metadaten für ein konfiguriertes Band werden auf die Parameter in einer SET_BAND_METADATA_PARAMETERS-Struktur festgelegt. Diese Struktur ist eine Eingabe für eine IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA Anforderung.
Syntax
typedef struct _SET_BAND_METADATA_PARAMETERS {
ULONG StructSize;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG MetadataOffset;
ULONG MetadataSize;
ULONG BufferOffset;
ULONG AuthKeyOffset;
} SET_BAND_METADATA_PARAMETERS, *PSET_BAND_METADATA_PARAMETERS;
Member
StructSize
Die Größe dieser Struktur in Bytes. Legen Sie auf sizeof(SET_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 Bandmetadateneigenschaft zum Festlegen der neuen Daten.
MetadataSize
Die Länge der festzulegenden Metadatenbytes. Diese Größe wird durch den Wert von MetadataOffset eingeschränkt, der vom BandMetadataSize-Member der BAND_MANAGEMENT_CAPABILITIES-Struktur subtrahiert wird.
BufferOffset
Der Offset in Bytes vom Anfang SET_BAND_METADATA_PARAMETERS bis zum Speicherort der neuen Metadaten.
AuthKeyOffset
Der Offset in Bytes einer AUTH_KEY Struktur, die den Autorisierungsschlüssel für das Band enthält. Der Offset ist von Anfang SET_BAND_METADATA_PARAMETERS. AUTH_KEY wird in ehstorbandmgmt.h wie folgt deklariert.
typedef struct _AUTH_KEY
{
ULONG KeySize;
UCHAR Key[ANYSIZE_ARRAY];
} AUTH_KEY;
KeySize
Größe des Schlüssels (in Bytes) der Schlüsseldaten bei Key. Wenn KeySize auf 0 festgelegt ist, wird ein Standardschlüssel verwendet.
Schlüssel
Ein Bytearray mit variabler Länge, das die Schlüsseldaten enthält.
Um einen Standardauthentifizierungsschlüssel für das Band anzugeben, legen Sie AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY fest.
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_SET_BAND_METADATA zurückgegeben.
Wenn BandID und BandStart beide auf –1 festgelegt sind, legt der IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA Metadaten für das globale Band fest.
Die Größe des Bandmetadatenspeichers befindet sich im BandMetadataSize-Member von BAND_MANAGEMENT_CAPABILITIES. Diese Struktur wird von einer IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES-Anforderung zurückgegeben.
Die neuen Metadaten, die für das Band festgelegt werden sollen, sind im Systempuffer für die IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA Anforderung enthalten und folgen dieser Struktur bei BufferOffset.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8 |
| Kopfzeile | ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h) |