estrutura ERASE_BAND_PARAMETERS (ehstorbandmgmt.h)
A estrutura ERASE_BAND_PARAMETERS contém os critérios de seleção de uma banda a ser apagada. Além disso, uma nova chave de autenticação pode ser definida. Essa estrutura é uma entrada para uma solicitação de IOCTL_EHSTOR_BANDMGMT_ERASE_BAND .
Sintaxe
typedef struct _ERASE_BAND_PARAMETERS {
ULONG StructSize;
ULONG Flags;
ULONG Reserved;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG NewAuthKeyOffset;
} ERASE_BAND_PARAMETERS, *PERASE_BAND_PARAMETERS;
Membros
StructSize
O tamanho dessa estrutura em bytes. Defina como sizeof(ERASE_BAND_PARAMETERS).
Flags
Excluir sinalizadores de operação. Esse valor é uma combinação OR bit a bit do seguinte.
| Valor | Significado |
|---|---|
|
A nova chave de autenticação para essa faixa é armazenada em cache, permitindo a automação de operações posteriores. |
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 o BandStart.
NewAuthKeyOffset
O deslocamento, em bytes, de uma estrutura AUTH_KEY que contém a nova chave de autorização para a banda. O deslocamento é do início do ERASE_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 NewAuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.
Comentários
A precedência é dada a BandID para seleção de banda. Se BandID for maior que 0 e BandID for menor que o membro MaxBandCount do BAND_MANAGEMENT_CAPABILITIES, o BandID será usado como os únicos critérios de seleção para uma correspondência de banda. Se BandID == –1, o 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_ERASE_BAND.
.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 8 |
| Cabeçalho | ehstorbandmgmt.h (inclua EhStorBandMgmt.h) |