estrutura ENUMERATE_BANDS_PARAMETERS (ehstorbandmgmt.h)

  • Artigo

A estrutura ENUMERATE_BANDS_PARAMETERS é usada para selecionar quais entradas de informações de banda são selecionadas para retornar de uma solicitação de IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS .

Sintaxe

typedef struct _ENUMERATE_BANDS_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  LARGE_INTEGER BandSize;
} ENUMERATE_BANDS_PARAMETERS, *PENUMERATE_BANDS_PARAMETERS;

Membros

StructSize

O tamanho dessa estrutura em bytes. Defina como sizeof(ENUMERATE_BANDS_PARAMETERS).

Flags

Sinalizadores de enumeração de banda. Esse valor é uma combinação OR bit a bit do seguinte.

Valor Significado
ENUMBANDS_ENUM_ALL_BANDS
 Todas as bandas são retornadas. Quando esse sinalizador é definido, os membros BandId, BandStart e BandSize são ignorados.
ENUMBANDS_REPORT_CRYPTO_ALGO
 Inclua informações de algoritmo de criptografia de mídia no membro SecurityInfo do BAND_TABLE_ENTRY.

Reserved

Reservado.

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.

BandSize

Um valor opcional de correspondência de tamanho de banda em bytes. Se BandSize == 0 e BandId == –1, BandStart será o único valor correspondente para selecionar uma banda. Caso contrário, uma banda em ou após BandStart e BandSize correspondentes exatamente será selecionada.

Comentários

Quando ENUMBANDS_ENUM_ALL_BANDS não está definido em Flags, uma tentativa de seleção é feita para corresponder a uma única banda. Uma única correspondência de banda é feita com base nos valores em BandID, BandStart e BandSize. A precedência é dada a BandID para seleção de banda. Se BandID> 0 e BandID<MaxBandCount membro de BAND_MANAGEMENT_CAPABILITIES Se BandID for maior que 0 e BandID for menor que o membro MaxBandCount de BAND_MANAGEMENT_CAPABILITIES, BandID será usado como o único critério de seleção para uma correspondência de banda. Se BandID == –1, BandStart e BandSize serão usados como critérios de correspondência para selecionar uma banda.

Quando BandStart e BandSize são usados para corresponder a uma banda, a primeira banda configurada em ou após o local BandStart ter o tamanho exato de BandSize é retornado. Se BandSize == 0, quando BandStart for válido, a primeira banda configurada em ou após BandStart será retornada.

Se BandID == 0 ou nenhuma faixa estiver configurada e Flags não estiver definido como ENUMBANDS_ENUM_ALL_BANDS, a banda global de todo o dispositivo será retornada.

BandStart e BandSize não são válidos, a menos que seus valores, em bytes, sejam múltiplos exatos do tamanho do setor do dispositivo de armazenamento subjacente.

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

BAND_TABLE

BAND_TABLE_ENTRY

IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS