HID Button Capability Arrays
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Uma matriz funcionalidade botão contém informações sobre os usos botão com suporte por uma de alto nível coleção para um tipo específico de relatório HID. A HIDP_CAPS estrutura contém informações sobre funcionalidade de uma coleção.
A seguinte tabela mostra as funções que drivers HID cliente podem usar para obter informações funcionalidade botão.
| Função | Descrição |
|---|---|
Retorna uma matriz funcionalidade botão descrevendo todos os usos de botão contidos em um tipo relatório especificado. |
|
Filtra as informações funcionalidade botão retornará por uma página uso Caller-specified, identificador de uso e coleção link. |
Contém uma matriz funcionalidade botão HIDP_BUTTON_CAPS estruturas. A seguinte lista mostra as informações contidas na HIDP_BUTTON_CAPS estrutura sobre um uso HID ou intervalo de uso:
- Página de uso para o uso ou intervalo de uso
- Identificador de relatório do relatório que contém os dados botão
- Identificador de uso ou intervalo de uso
- Sinalizador que indica se um uso é um uso de alias
- Coleção Links que contém o uso ou intervalo de uso
- Seqüência de caracteres descritores e os designadores associado com o uso ou intervalo de uso
- Índices de dados que o analisador HID atribuída ao uso ou intervalo de uso
A seguinte lista mostra as condições gerais para todos os usos descritos por uma matriz funcionalidade botão:
- Cada estrutura funcionalidade representa um único uso ou intervalo de uso que está associado com uma variável item principal ou uma matriz item principal.
- Variável itens principais podem usar usos de alias. Um uso que está associado com uma matriz item não pode ser alias. Um intervalo de uso não pode ser alias.
- O analisador HID usa apenas o mínimo exigido número de usos para atribuir um uso para cada botão. O analisador atribui usos na ordem na qual o descritor relatório especifica. O analisador descarta usos em um descritor relatório que não são exigido. A matriz funcionalidade botão não contém quaisquer informações sobre usos descartados.
- Se o número de usos especificado para uma variável item é menor que o número de botões no item, a matriz funcionalidade contém apenas uma funcionalidade estrutura que descreve uma utilização botão, que é o último uso especificado no descritor de relatório para a variável item principal.
- O analisador HID atribui um exclusivo índice dados para cada uso descrito na matriz a funcionalidade.
Variável usos do botão do item principal
Estruturas capacidade em uma matriz funcionalidade botão descrever cada uso ou intervalo de uso especificado em um descritor relatório.
O IsAlias membro de estruturas funcionalidade é TRUE em cada estrutura, exceto a última estrutura adicionada à matriz de funcionalidade. IsAlias é FALSE na última estrutura funcionalidade. O uso preferencial é o uso de alias último na seqüência.
Um driver HID pode determinar quais usos botão são alias pelo exame para essas seqüências.
A seguinte tabela mostra um exemplo de usos de alias.
| Ordem de uso de alias descritor relatório | Ordem de uso matriz capacidade | Valor IsAlias |
|---|---|---|
Uso 1 |
Usage 3 |
TRUE |
Usage 2 |
Usage 2 |
TRUE |
Usage 3 |
Uso 1 |
FALSE |
Usos do botão do item principal de matriz
Uma estrutura funcionalidade em uma matriz funcionalidade botão descreve cada uso ou intervalo de uso para uma matriz botão principal item especificado em um descritor relatório. A ordem na qual as estruturas funcionalidade são adicionadas a uma matriz funcionalidade é o inverter a ordem na qual os usos forem especificados para um item principal do.
O analisador HID atribui um índice dados a cada uso associado com a matriz item na ordem na qual um descritor relatório especifica os usos.
A seguinte tabela mostra a correspondência entre um conjunto de usos, conforme especificado em um descritor relatório e os índices usos e dados, conforme especificado na matriz a funcionalidade. Nessa tabela, n é o primeiro índice dados que o analisador atribui ao primeiro uso associado com a matriz item.
| Ordem de uso descritor relatório | Ordem de uso matriz capacidade | DataIndex ou DataIndexMax - DataIndexMin |
|---|---|---|
Uso 1 |
Intervalo de uso 2 |
A partir n+ 7 para n+8 |
Uso intervalo 1, com usos 4 |
Usage 2 |
n+5 |
Usage 2 |
Usage range 1 |
A partir n+1 to n+4 |
Uso intervalo 2, com usos 2 |
Uso 1 |
n |