struttura CREATE_BAND_PARAMETERS (ehstorbandmgmt.h)

Articolo
02/27/2024

I parametri per creare una banda in un dispositivo di archiviazione per una richiesta di IOCTL_EHSTOR_BANDMGMT_CREATE_BAND vengono specificati in una struttura CREATE_BAND_PARAMETERS .

Sintassi

typedef struct _CREATE_BAND_PARAMETERS {
  ULONG StructSize;
  ULONG Flags;
  ULONG BandLocationInfoOffset;
  ULONG BandSecurityInfoOffset;
  ULONG AuthKeyOffset;
} CREATE_BAND_PARAMETERS, *PCREATE_BAND_PARAMETERS;

Members

StructSize

La dimensione di questa struttura in byte. Impostare su sizeof(CREATE_BAND_PARAMETERS).

Flags

Flag di creazione della banda. Questo valore è una combinazione OR bit per bit della seguente.

Valore	Significato
CREATEBAND_AUTHKEY_CACHING_ENABLED	La chiave di autenticazione per questa banda viene memorizzata nella cache, che consente l'automazione delle operazioni successive. La chiave di autenticazione viene memorizzata nella cache quando questo flag è impostato e la banda non è bloccata sia per la lettura che per la scrittura.

BandLocationInfoOffset

Offset, in byte, di una struttura BAND_LOCATION_INFO . L'offset proviene dall'inizio di CREATE_BAND_PARAMETERS.

BandSecurityInfoOffset

Offset, in byte, di una struttura BAND_SECURITY_INFO . L'offset proviene dall'inizio di CREATE_BAND_PARAMETERS. Se questo valore è 0, ovvero le informazioni di sicurezza della banda non sono presenti, i metadati del gestore chiavi per la banda vengono impostati su tutti gli zeri. Inoltre, quando questo membro è 0, per impostazione predefinita gli stati di blocco di lettura e scrittura sono PERSISTANT_UNLOCK.

AuthKeyOffset

Offset, in byte, di una struttura AUTH_KEY che contiene la chiave di autorizzazione per la nuova banda. L'offset proviene dall'inizio di CREATE_BAND_PARAMETERS. AUTH_KEY viene dichiarato in ehstorbandmgmt.h come indicato di seguito.

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

KeySize

Dimensioni della chiave, in byte, dei dati della chiave in Chiave. Se KeySize è impostato su 0, viene usata una chiave predefinita.

Chiave

Matrice di byte a lunghezza variabile che contiene i dati chiave.

Per assegnare una chiave di autorizzazione predefinita alla banda, impostare AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.

Commenti

I membri CryptoAlgoIdType e CryptoAlgoOidString della struttura BAND_SECURITY_INFO in BandSecurityInfoOffset non vengono usati in una richiesta di creazione della banda e devono essere impostati su 0.