estrutura SET_BAND_METADATA_PARAMETERS (ehstorbandmgmt.h)
Os metadados de uma banda configurada são definidos como parâmetros em uma estrutura de SET_BAND_METADATA_PARAMETERS. Essa estrutura é uma entrada para uma solicitação de IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA.
Sintaxe
typedef struct _SET_BAND_METADATA_PARAMETERS {
ULONG StructSize;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG MetadataOffset;
ULONG MetadataSize;
ULONG BufferOffset;
ULONG AuthKeyOffset;
} SET_BAND_METADATA_PARAMETERS, *PSET_BAND_METADATA_PARAMETERS;
Membros
StructSize
O tamanho dessa estrutura em bytes. Defina como tamanhos de(SET_BAND_METADATA_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 BandStart.
MetadataOffset
O deslocamento do início da propriedade de metadados de banda para definir os novos dados.
MetadataSize
O comprimento dos bytes de metadados a serem definidos. Esse tamanho é limitado pelo valor de MetadataOffset subtraída do membro BandMetadataSize da estrutura BAND_MANAGEMENT_CAPABILITIES.
BufferOffset
O deslocamento, em bytes, desde o início do SET_BAND_METADATA_PARAMETERS até o local dos novos metadados.
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 SET_BAND_METADATA_PARAMETERS. AUTH_KEY é declarado em ehstorbandmgmt.h como o seguinte.
typedef struct _AUTH_KEY
{
ULONG KeySize;
UCHAR Key[ANYSIZE_ARRAY];
} AUTH_KEY;
KeySize
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.
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_SET_BAND_METADATA.
Se BandID e BandStart estiverem definidos como –1, o IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA definirá metadados para a banda global.
O tamanho do repositório de metadados de banda é encontrado no membro BandMetadataSize do BAND_MANAGEMENT_CAPABILITIES. Essa estrutura é retornada de uma solicitação IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES.
Os novos metadados a serem definidos para a banda são incluídos no buffer do sistema para a solicitação de IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA e seguem essa estrutura em bufferOffset.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 8 |
| cabeçalho | ehstorbandmgmt.h (inclua EhStorBandMgmt.h) |