estrutura ENUMERATE_BANDS_PARAMETERS (ehstorbandmgmt.h)
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 tamanhos de(ENUMERATE_BANDS_PARAMETERS).
Flags
Sinalizadores de enumeração de banda. Esse valor é uma combinação OR bit a bit do seguinte.
| Valor | Significado |
|---|---|
|
Todas as bandas são retornadas. Quando esse sinalizador é definido, os membros BandId, BandStarte BandSize são ignorados. |
|
Inclua informações de algoritmo de criptografia de mídia no SecurityInfo membro 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 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.
BandSize
Um valor de correspondência de tamanho de banda opcional em bytes. Se BandSize == 0 e BandId == –1, BandStart será o único valor de correspondência para selecionar uma banda. Caso contrário, uma banda em ou após BandStart e bandSize correspondente está selecionada exatamente.
Observações
Quando ENUMBANDS_ENUM_ALL_BANDS não é 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, BandStarte BandSize. A precedência é dada a BandID para seleção de banda. Se BandID> 0 e BandID<MaxBandCount membro do BAND_MANAGEMENT_CAPABILITIES If BandID for maior que 0 e BandID for menor do que o membro MaxBandCount 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 e bandSize sã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 BandStart local com 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 banda estiver configurada e Flags não estiver definida 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 |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 8 |
| cabeçalho | ehstorbandmgmt.h (inclua EhStorBandMgmt.h) |