IOCTL_EHSTOR_BANDMGMT_ACTIVATE IOCTL (ehstorbandmgmt.h)

  • Artikel

Diese IOCTL_EHSTOR_BANDMGMT_ACTIVATE Anforderung wird gesendet, um die Sicherheitsfeatures und die Bandverwaltung auf einem Speichergerät zu aktivieren. Die Anforderung enthält Aktivierungsoptionen und den Authentifizierungsschlüssel.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Der Eingabepuffer bei Irp-AssociatedIrp.SystemBuffer> enthält eine ACTIVATE_REVERT_PARAMETERS-Struktur. ACTIVATE_REVERT_PARAMETERS wird in ehstorbandmgmt.h wie folgt deklariert.

typedef struct _ACTIVATE_REVERT_PARAMETERS
{
    ULONG           StructSize;
    ULONG           Flags;
    ULONG           AuthKeyOffset;
} ACTIVATE_REVERT_PARAMETERS;

Die folgende ACTIVATE_REVERT_PARAMETERS im Systempuffer ist eine AUTH_KEY-Struktur . Dies enthält die Schlüsseldatenbytes für den Authentifizierungsschlüssel. AUTH_KEY wird in ehstorbandmgmt.h wie folgt deklariert.

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

Eingabepufferlänge

Die Länge einer ACTIVATE_REVERT_PARAMETERS-Struktur .

Ausgabepuffer

Keine.

Länge des Ausgabepuffers

Keine.

Statusblock

Einer der folgenden Werte kann im Feld Status zurückgegeben werden.

Statuswert BESCHREIBUNG
STATUS_SUCCESS Sicherheitsfeatures auf dem Speichergerät wurden aktiviert.
STATUS_INVALID_DEVICE_REQUEST Das Speichergerät unterstützt keine Bandverwaltung.
STATUS_INVALID_BUFFER_SIZE Die Eingabepuffergröße ist ungültig.
STATUS_INVALID_PARAMETER Die Informationen im Eingabepuffer sind ungültig.
STATUS_ACCESS_DENIED Der Authentifizierungsschlüssel ist ungültig. Die Aktivierung wird verweigert.
STATUS_DEVICE_CONFIGURATION_ERROR Das System kann das Gerät nicht in einem unterstützten Modus konfigurieren.
STATUS_IO_DEVICE_ERROR Fehler bei der Kommunikation. Das Speichergerät ist möglicherweise nicht mit Sicherheitsprotokollen kompatibel.
STATUS_INVALID_DEVICE_STATE Das Speichergerät ist bereits aktiviert.
STATUS_NOT_SUPPORTED Sicherheitsfeatures auf dem Gerät wurden aufgrund einer Gruppenrichtlinie-Einstellung nicht aktiviert.

Hinweise

Wenn STATUS_SUCCESS von dieser Anforderung zurückgegeben wird, kann ein Treiber oder eine Anwendung eine IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES Anforderung senden, um die aktivierten Bandverwaltungsfunktionen des Geräts abzurufen.

Vor einer erfolgreichen Rückgabe von IOCTL_EHSTOR_BANDMGMT_ACTIVATE wird das Gerät nicht aktiviert. Bis das Gerät aktiviert ist, ist die einzige Bandverwaltungs-IOCTL, die erfolgreich zurückgegeben wird , IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES. Nach der Aktivierung sind die verbleibenden Bandverwaltungs-IOCTLs verfügbar.

Die Aktivierung von Enhanced Storage-Geräten wird durch die Gruppenrichtlinie Einstellungen des Systems gesteuert. Der Registrierungswert unter HKLM\Software\Policies\Microsoft\Windows\EnhancedStorageDevices\TCGSecurityActivationDisabled bestimmt, ob die Sicherheitsaktivierung aktiviert ist. Ein REG_DWORD Wert von 0 ermöglicht die Sicherheitsaktivierung auf dem Speichergerät. Andernfalls deaktiviert der Wert 1 die Sicherheitsaktivierung, und die IOCTL_EHSTOR_BANDMGMT_ACTIVATE Anforderung wird mit STATUS_NOT_SUPPORTED zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 8.
Kopfzeile ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h)

Weitere Informationen

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_REVERT