estrutura CREATE_BAND_PARAMETERS (ehstorbandmgmt.h)

Artigo
02/29/2024

Os parâmetros para criar uma banda em um dispositivo de armazenamento para uma solicitação IOCTL_EHSTOR_BANDMGMT_CREATE_BAND são especificados em uma estrutura CREATE_BAND_PARAMETERS .

Sintaxe

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

Membros

StructSize

O tamanho dessa estrutura em bytes. Defina como sizeof(CREATE_BAND_PARAMETERS).

Flags

Sinalizadores de criação de banda. Esse valor é uma combinação OR bit a bit do seguinte.

Valor	Significado
CREATEBAND_AUTHKEY_CACHING_ENABLED	A chave de autenticação dessa banda é armazenada em cache, o que permite a automação de operações posteriores. A chave de autenticação é armazenada em cache quando esse sinalizador é definido e a banda não está bloqueada para leitura e gravação.

BandLocationInfoOffset

O deslocamento, em bytes, de uma estrutura BAND_LOCATION_INFO . O deslocamento é desde o início de CREATE_BAND_PARAMETERS.

BandSecurityInfoOffset

O deslocamento, em bytes, de uma estrutura BAND_SECURITY_INFO . O deslocamento é desde o início de CREATE_BAND_PARAMETERS. Se esse valor for 0, o que significa que as informações de segurança de banda não estão presentes, os metadados do gerenciador de chaves para a banda serão definidos como todos os zeros. Além disso, quando esse membro é 0, os estados de bloqueio de leitura e gravação assumem como padrão PERSISTANT_UNLOCK.

AuthKeyOffset

O deslocamento, em bytes, de uma estrutura AUTH_KEY que contém a chave de autorização para a nova banda. O deslocamento é desde o início de CREATE_BAND_PARAMETERS. AUTH_KEY é declarado em ehstorbandmgmt.h como o seguinte.

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

KeySize

O tamanho da chave, em bytes, dos dados de chave em Key. Se KeySize for definido como 0, uma chave padrão será usada.

Chave

Uma matriz de bytes de comprimento variável que contém os dados de chave.

Para atribuir uma chave de autorização padrão à banda, defina AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.

Comentários

Os membros CryptoAlgoIdType e CryptoAlgoOidString da estrutura BAND_SECURITY_INFO em BandSecurityInfoOffset não são usados em uma solicitação de criação de banda e devem ser definidos como 0.