HID Value 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 valor contém informações sobre os usos valor com suporte por uma de alto nível coleção para um tipo específico de relatório HID. Informações sobre valor funcionalidade matrizes de uma coleção estão contidas em seu HIDP_CAPS estrutura.
A seguinte tabela mostra as funções que um driver cliente HID pode usar para obter informações funcionalidade botão.
| Função | Descrição |
|---|---|
Retorna uma matriz funcionalidade valor descrevendo todos os valores contidos em um tipo relatório Caller-specified. |
|
Filtra as informações funcionalidade valor que ele retorna uma página uso Caller-specified, uso, coleção link e tipo relatório. |
Contém uma matriz funcionalidade valor HIDP_VALUE_CAPS estruturas. A seguinte lista mostra as informações contidas em um HIDP_VALUE_CAPS estrutura:
- Página de uso para um uso ou intervalo de uso
- Identificador de relatório do relatório que contém o valor
- Identificador de uso ou um intervalo de uso
- Se um uso é alias
- Coleção Links que contém o uso ou intervalo de uso
- Tamanho, em bits, de um valor e a contagem relatório, que é o número de individual valores descritos pela estrutura
- Atributos de cada valor, incluindo se ele tem um NULL valor, suas unidades e expoente e seu lógico e físico intervalos
- Seqüência de caracteres descritores e os designadores associado com o uso ou intervalo de uso
- Índices de dados que o analisador HID atribui um uso ou intervalo de uso
A seguinte lista mostra as condições gerais para todos os usos descritos por uma matriz funcionalidade valor:
- Cada estrutura funcionalidade representa um uso, um intervalo de uso ou uma matriz valor de uso que está associado com uma variável item principal. Itens principais de matriz não são com suporte para valores.
- Usos com alias podem ser usados. Um intervalo de uso não pode ser alias. Valores com alias são vinculados juntos em uma matriz funcionalidade valor da mesma maneira como os botões de alias como vinculado juntos em uma matriz funcionalidade botão.
- O analisador HID usa apenas o mínimo exigido usos para atribuir um uso para cada valor. O analisador atribui usos na ordem que especificar descritores relatório-los. Usos em um descritor relatório que não são exigido é descartados. A matriz funcionalidade valor não contém quaisquer informações sobre usos descartados.
- O analisador HID atribui um exclusivo índice dados para cada uso descrito na matriz a funcionalidade.
Matrizes de valor de uso
Uma matriz valor de uso é um conjunto de valores especificados em um item principal, todos que tenham o mesmo uso consecutivo. Isso ocorre se apenas um uso for especificado para um item principal cuja contagem relatório é Maior do que um.
Se a contagem relatório para um uso for uma, use HidP_GetUsageValue Para extrair o valor de uso. Se relatório contagem do uso for maior do que um, HidP_GetUsageValue Somente retorna a primeira item de dados em uma matriz valor de uso. Para extrair todos os dados itens em uma matriz valor de uso, use HidP_GetUsageValueArray.