estrutura GET_BAND_METADATA_PARAMETERS (ehstorbandmgmt.h)
Os metadados de uma banda configurada são recuperados de acordo com os parâmetros em uma estrutura de GET_BAND_METADATA_PARAMETERS. Essa estrutura é uma entrada para uma solicitação de IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA.
Sintaxe
typedef struct _GET_BAND_METADATA_PARAMETERS {
ULONG StructSize;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG MetadataOffset;
ULONG MetadataSize;
} GET_BAND_METADATA_PARAMETERS, *PGET_BAND_METADATA_PARAMETERS;
Membros
StructSize
O tamanho dessa estrutura em bytes. Definido como tamanhos de(GET_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 da qual recuperar dados.
MetadataSize
O comprimento dos bytes de metadados a serem recuperados.
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_GET_BAND_METADATA.
Se BandID e BandStart estiverem definidos como –1, o IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA retornará metadados para a banda global.
Se IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA tiver sido bem-sucedido, Parameters.DeviceIoControl.InputBufferLength será igual ao valor em MetadadosSize.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 8 |
| cabeçalho | ehstorbandmgmt.h (inclua EhStorBandMgmt.h) |