estructura CREATE_BAND_PARAMETERS (ehstorbandmgmt.h)

Artículo
02/26/2024

Los parámetros para crear una banda en un dispositivo de almacenamiento para una solicitud de IOCTL_EHSTOR_BANDMGMT_CREATE_BAND se especifican en una estructura de CREATE_BAND_PARAMETERS .

Sintaxis

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

Miembros

StructSize

Tamaño de esta estructura en bytes. Establezca en sizeof(CREATE_BAND_PARAMETERS).

Flags

Marcas de creación de banda. Este valor es una combinación OR bit a bit de lo siguiente.

Valor	Significado
CREATEBAND_AUTHKEY_CACHING_ENABLED	La clave de autenticación de esta banda se almacena en caché, lo que permite la automatización de las operaciones posteriores. La clave de autenticación se almacena en caché cuando se establece esta marca y la banda no está bloqueada tanto para lectura como para escritura.

BandLocationInfoOffset

Desplazamiento, en bytes, de una estructura BAND_LOCATION_INFO . El desplazamiento es desde el principio de CREATE_BAND_PARAMETERS.

BandSecurityInfoOffset

Desplazamiento, en bytes, de una estructura BAND_SECURITY_INFO . El desplazamiento es desde el principio de CREATE_BAND_PARAMETERS. Si este valor es 0, lo que significa que la información de seguridad de banda no está presente, los metadatos del administrador de claves de la banda se establecen en todos los ceros. Además, cuando este miembro es 0, los estados de bloqueo de lectura y escritura tienen como valor predeterminado PERSISTANT_UNLOCK.

AuthKeyOffset

Desplazamiento, en bytes, de una estructura de AUTH_KEY que contiene la clave de autorización para la nueva banda. El desplazamiento es desde el principio de CREATE_BAND_PARAMETERS. AUTH_KEY se declara en ehstorbandmgmt.h como se indica a continuación.

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

KeySize

Tamaño de la clave, en bytes, de los datos de clave en Key. Si KeySize se establece en 0, se usa una clave predeterminada.

Clave

Matriz de bytes de longitud variable que contiene los datos de clave.

Para asignar una clave de autorización predeterminada a la banda, establezca AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.

Comentarios

Los miembros CryptoAlgoIdType y CryptoAlgoOidString de la estructura de BAND_SECURITY_INFO en BandSecurityInfoOffset no se usan en una solicitud de creación de banda y deben establecerse en 0.