BAND_MANAGEMENT_CAPABILITIES Struktur (ehstorbandmgmt.h)

Artikel
02/06/2025

Die BAND_MANAGEMENT_CAPABILITIES-Struktur enthält die Sicherheitsfunktionen, die für ein Speichergerät verfügbar sind. Diese Struktur wird vom IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES-Anforderung im Systempuffer zurückgegeben.

Syntax

typedef struct _BAND_MANAGEMENT_CAPABILITIES {
  ULONG     StructSize;
  ULONG     Capabilities;
  ULONGLONG KeyProtectionMechanism;
  ULONG     MinAuthKeyLength;
  ULONG     MaxAuthKeyLength;
  ULONG     MaxBandCount;
  ULONG     MaxSimultaneousReencryptionCount;
  ULONG     BandMetadataSize;
} BAND_MANAGEMENT_CAPABILITIES, *PBAND_MANAGEMENT_CAPABILITIES;

Angehörige

StructSize

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

Capabilities

Sicherheitsfunktionskennzeichnungen für ein Speichergerät. Dies ist ein bitweiser OR-Wert der folgenden Flags.

Wert	Bedeutung
CAPS_ACTIVATED	Wenn festgelegt, sind die Funktionsmber dieser Struktur verfügbar. Andernfalls sind die verbleibenden Elemente dieser Struktur ungültig.
CAPS_BANDCROSSING_SUPPORTED	Das Speichergerät unterstützt Lese- und Schreibvorgänge über mehrere Bänder hinweg. Wenn dieses Kennzeichen nicht festgelegt ist, werden einzelne Lese- oder Schreibvorgänge, die mehrere Bänder umfassen, in mehrere E/A-Anforderungen für ein Gerät unterteilt.
CAPS_SID_SECURED	SID-Autorität ist gesichert. Bei Festlegung kann der Standard-SID-Pin nicht verwendet werden, um die Sicherheitskonfiguration des Speichergeräts zu ändern.

KeyProtectionMechanism

Der Mechanismus zum Schutz der Medientasten. Dieses Element ist auf eine der folgenden Elemente festgelegt.

Wert	Bedeutung
0	Schlüssel sind nicht geschützt.
MEDIAKEY_PROTECTEDBY_VENDORSCHEME	Schlüssel werden durch eine vom Anbieter bereitgestellte Methode geschützt. Nicht verwenden. Diese Option wird nicht unterstützt.
MEDIAKEY_PROTECTEDBY_AUTHKEY	Schlüssel werden durch Schlüssel verschlüsselt, die von Bandauthentifizierungsschlüsseln abgeleitet sind. Die Schlüsselableitung führt zu vernachlässigbaren Entropieverlusten aus den Bandauthentifizierungsdaten.

MinAuthKeyLength

Die Mindestlänge in Bytes der Bandauthentifizierung oder das Löschen von Schlüsseln, die vom Speichergerät akzeptiert werden.

MaxAuthKeyLength

Die maximale Länge (in Byte) der Bandauthentifizierung oder das Löschen von Schlüsseln, die vom Speichergerät akzeptiert werden.

MaxBandCount

Die maximale Anzahl gleichzeitiger Bänder, die auf dem Speichergerät konfiguriert sind. Dazu gehört auch das globale Band.

MaxSimultaneousReencryptionCount

Die Anzahl der gleichzeitigen Bandverschlüsselungen, die die Hardware auf dem Gerät unterstützt. Wenn dieses Mitglied 0 ist, werden hardwaregesteuerte Band-Re-Verschlüsselungen nicht unterstützt.

BandMetadataSize

Die Größe des Metadatenspeichers pro Band in Bytes.

Bemerkungen

Wenn CAPS_ACTIVATED in Funktionennicht festgelegt ist, kann die Sicherheitsfunktionalität mit der IOCTL_EHSTOR_BANDMGMT_ACTIVATE-Anforderung aktiviert werden.

Anforderungen

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

Siehe auch

IOCTL_EHSTOR_BANDMGMT_ACTIVATE

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

Freigeben über