estrutura GET_BAND_METADATA_PARAMETERS (ehstorbandmgmt.h)

  • Artigo

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)

Confira também

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA