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 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. Defina como sizeof(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 bytes inicial no dispositivo de armazenamento para iniciar uma pesquisa de banda. É feita uma tentativa de fazer a correspondência de 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.
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 o único critério 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_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 MetadataSize.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Disponível a partir do Windows 8 |
Cabeçalho | ehstorbandmgmt.h (inclua EhStorBandMgmt.h) |