estrutura DELETE_BAND_PARAMETERS (ehstorbandmgmt.h)

Artigo
02/06/2025

Uma banda configurada é excluída de acordo com os parâmetros em uma estrutura de DELETE_BAND_PARAMETERS. Essa estrutura é uma entrada para uma solicitação de IOCTL_EHSTOR_BANDMGMT_DELETE_BAND.

Sintaxe

typedef struct _DELETE_BAND_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         AuthKeyOffset;
} DELETE_BAND_PARAMETERS, *PDELETE_BAND_PARAMETERS;

Membros

StructSize

O tamanho dessa estrutura em bytes. Definido como tamanhos de(DELETE_BAND_PARAMETERS).

Flags

Excluir sinalizadores de operação. Esse valor é uma combinação OR bit a bit do seguinte.

Valor	Significado
DELBAND_ERASE_BEFORE_DELETE	Execute uma exclusão criptográfica dos dados da propriedade de banda antes da exclusão.

Reserved

Reservado.

BandId

O identificador de uma única banda para a qual retornar informações. bandSize deve ser 0 quando uma única banda é selecionada com BandId. Para usar BandStart e BandSize em vez de BandId para selecionar uma banda, defina BandId = (ULONG) –1.

BandStart

O local de byte inicial no dispositivo de armazenamento para iniciar uma pesquisa de banda. É feita uma tentativa de corresponder a uma banda em ou após BandStart.

AuthKeyOffset

O deslocamento, em bytes, de uma estrutura de AUTH_KEY que contém a chave de autorização da banda. O deslocamento é do início de DELETE_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 especificar uma chave de autenticação padrão para a banda, defina AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY. Se Flags contiver DELBAND_ERASE_BEFORE_DELETE, AuthKeyOffset deverá ser definido como EHSTOR_BANDMGR_NO_KEY.

Observações

A precedência é dada a BandID para seleção de banda. Se BandID for maior que 0 e BandID for menor que o maxbandcount membro do BAND_MANAGEMENT_CAPABILITIES, BandID será usado como o único critério de seleção para uma correspondência de banda. Se BandID == –1, BandStart será usado como critério de correspondência para selecionar uma banda. Se nenhuma faixa corresponder a nenhum dos critérios de seleção, STATUS_INVALID_PARAMETER será retornado no bloco IoStatus para IOCTL_EHSTOR_BANDMGMT_DELETE_BAND.

Se DELBAND_ERASE_BEFORE_DELETE estiver definido no sinalizadores do, uma chave de autenticação não será necessária para excluir a banda. Se esse sinalizador não estiver definido, a chave de autenticação atual deverá ser incluída em AuthKeyOffset.