struttura BAND_MANAGEMENT_CAPABILITIES (ehstorbandmgmt.h)

Articolo
02/06/2025

La struttura BAND_MANAGEMENT_CAPABILITIES contiene le funzionalità di sicurezza disponibili per un dispositivo di archiviazione. Questa struttura viene restituita nel buffer di sistema dalla richiesta IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES.

Sintassi

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;

Membri

StructSize

Dimensione di questa struttura in byte. Impostare su sizeof(BAND_MANAGEMENT_CAPABILITIES).

Capabilities

Flag di funzionalità di sicurezza per un dispositivo di archiviazione. Si tratta di un valore OR bit per bit dei flag seguenti.

Valore	Significato
CAPS_ACTIVATED	Se impostata, sono disponibili i membri della funzionalità di questa struttura. In caso contrario, i membri rimanenti di questa struttura non sono validi.
CAPS_BANDCROSSING_SUPPORTED	Il dispositivo di archiviazione supporta letture e scritture tra più bande. Se questo flag non è impostato, le letture singole o le scritture che si estendono su più bande sono suddivise in più richieste di I/O per un dispositivo.
CAPS_SID_SECURED	L'autorità SID è protetta. Se impostato, il pin SID predefinito non può essere usato per modificare la configurazione di sicurezza del dispositivo di archiviazione.

KeyProtectionMechanism

Meccanismo usato per proteggere le chiavi multimediali. Questo membro è impostato su uno dei seguenti elementi.

Valore	Significato
0	Le chiavi non sono protette.
MEDIAKEY_PROTECTEDBY_VENDORSCHEME	Le chiavi sono protette da un metodo fornito dal fornitore. Non usare. Questa opzione non è supportata.
MEDIAKEY_PROTECTEDBY_AUTHKEY	Le chiavi vengono crittografate dalle chiavi derivate dalle chiavi di autenticazione a banda. La derivazione della chiave comporta una perdita di entropia trascurabile dai dati di autenticazione della banda.

MinAuthKeyLength

Lunghezza minima, in byte, dell'autenticazione della banda o delle chiavi di cancellazione accettate dal dispositivo di archiviazione.

MaxAuthKeyLength

Lunghezza massima, in byte, dell'autenticazione della banda o delle chiavi di cancellazione accettate dal dispositivo di archiviazione.

MaxBandCount

Numero massimo di bande simultanee configurate nel dispositivo di archiviazione. Questo include la banda globale.

MaxSimultaneousReencryptionCount

Il numero di ricrittografa simultaneamente l'hardware nel dispositivo. Se questo membro è 0, le ricrittografie basate su hardware non sono supportate.

BandMetadataSize

Dimensione, in byte, dell'archivio di metadati per banda.

Osservazioni

Se CAPS_ACTIVATED non è impostato in Capabilities, la funzionalità di sicurezza può essere attivata con la richiesta di IOCTL_EHSTOR_BANDMGMT_ACTIVATE.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 8
intestazione	ehstorbandmgmt.h (include EhStorBandMgmt.h)

Vedere anche

IOCTL_EHSTOR_BANDMGMT_ACTIVATE

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

Condividi tramite