SET_BAND_LOCATION_PARAMETERS Struktur (ehstorbandmgmt.h)
Die SET_BAND_LOCATION_PARAMETERS-Struktur gibt die Parameter an, um Standorteigenschaften für ein Band auf einem Speichergerät für eine IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION Anforderung festzulegen.
Syntax
typedef struct _SET_BAND_LOCATION_PARAMETERS {
ULONG StructSize;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG AuthKeyOffset;
ULONG BandLocationInfoOffset;
} SET_BAND_LOCATION_PARAMETERS, *PSET_BAND_LOCATION_PARAMETERS;
Member
StructSize
Die Größe dieser Struktur in Bytes. Legen Sie auf sizeof(SET_BAND_LOCATION_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.
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_LOCATION_PARAMETERS. AUTH_KEY wird in ehstorbandmgmt.h wie folgt deklariert.
typedef struct _AUTH_KEY
{
ULONG KeySize;
UCHAR Key[ANYSIZE_ARRAY];
} AUTH_KEY;
KeySize
Die 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 Standardautorisierungsschlüssel für das Band anzugeben, legen Sie AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY fest.
BandLocationInfoOffset
Der Offset einer BAND_LOCATION_INFO-Struktur in Bytes. Der Offset ist von Anfang SET_BAND_LOCATION_PARAMETERS.
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_LOCATION zurückgegeben.
Wenn BandID und BandStart auf –1 festgelegt sind, ändert die IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION Anforderung die Eigenschaften des globalen Bandes.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8 |
| Kopfzeile | ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h) |