estrutura SET_BAND_LOCATION_PARAMETERS (ehstorbandmgmt.h)
A estrutura SET_BAND_LOCATION_PARAMETERS especifica os parâmetros para definir propriedades de localização para uma banda em um dispositivo de armazenamento para uma solicitação de IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION .
Sintaxe
typedef struct _SET_BAND_LOCATION_PARAMETERS {
ULONG StructSize;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG AuthKeyOffset;
ULONG BandLocationInfoOffset;
} SET_BAND_LOCATION_PARAMETERS, *PSET_BAND_LOCATION_PARAMETERS;
Membros
StructSize
O tamanho dessa estrutura em bytes. Defina como sizeof(SET_BAND_LOCATION_PARAMETERS).
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.
AuthKeyOffset
O deslocamento, em bytes, de uma estrutura AUTH_KEY que contém a chave de autorização para a banda. O deslocamento é do início do SET_BAND_LOCATION_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 autorização padrão para a banda, defina AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.
BandLocationInfoOffset
O deslocamento, em bytes, de uma estrutura BAND_LOCATION_INFO . O deslocamento é do início do SET_BAND_LOCATION_PARAMETERS.
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_SET_BAND_LOCATION.
Se BandID e BandStart estiverem definidos como –1, a solicitação IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION alterará as propriedades da banda global.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 8 |
| Cabeçalho | ehstorbandmgmt.h (inclua EhStorBandMgmt.h) |