Matrizes de capacidades de valor

Uma matriz de recursos de valor contém informações sobre os usos de valor compatíveis com uma coleção de nível superior para um tipo específico de relatório HID. As informações sobre as arrays de capacidade de valor de uma coleção estão contidas em sua estrutura HIDP_CAPS.

Um aplicativo de modo usuário ou driver de modo kernel usa uma das seguintes rotinas de suporte HIDClass para obter informações de capacidade do botão.

• HidP_GetValueCaps retorna uma matriz de funcionalidade de valor que descreve todos os valores contidos em um tipo de relatório especificado pelo chamador.

• HidP_GetSpecificValueCaps filtra as informações de funcionalidade de valor retornadas por uma página de uso, uso, coleção de links e tipo de relatório especificados pelo chamador.

Uma matriz de recursos de valor contém estruturas de HIDP_VALUE_CAPS, cada uma das quais descreve as seguintes informações sobre um uso HID ou intervalo de uso:

• A página de uso de um uso ou faixa de uso

• A ID do relatório que contém o valor

• Uma ID de uso ou um intervalo de uso

• Indica se um uso é um uso com alias

• Informações sobre a coleção de links que contém o uso ou o intervalo de uso.

• O tamanho, em bits, de um valor e a contagem de relatórios (que é o número de valores individuais descritos pela estrutura)

• Atributos de cada valor, incluindo: se ele tem um valor nulo, suas unidades e expoente e seus intervalos lógicos e físicos

• Informações sobre descritores de strings e designadores associados ao uso ou intervalo de uso

• Informações sobre os índices de dados que o analisador HID atribui a um uso ou intervalo de uso

Em geral, as seguintes condições são mantidas para todos os usos descritos por uma matriz de funcionalidade de valor:

• Cada estrutura de funcionalidade representa um uso, um intervalo de uso ou uma matriz de valor de uso associada a um item principal de variável. Não há suporte para itens principais de matriz para valores.

• Podem ser utilizados usos com alias. Um intervalo de uso não pode ser referenciado. Os valores com alias são vinculados em uma matriz de capacidade de valor da mesma forma que botões com alias são vinculados em uma matriz de capacidade de botão. Consulte Uso de Botões em um Item Principal Variável.

• O analisador HID usa apenas os usos mínimos necessários para atribuir um uso a cada valor. O analisador atribui usos na ordem em que eles são especificados em um descritor de relatório. Os usos em um descritor de relatório que não são necessários são descartados. A matriz de funcionalidade de valor não contém informações sobre usos descartados.

• O analisador HID atribui um índice de dados exclusivo a cada uso descrito na matriz de funcionalidades.

Para obter uma descrição de como os índices de dados são atribuídos a valores, consulte Índices de Dados.

Matriz de valor de uso

Uma matriz de valor de uso é um conjunto consecutivo de valores especificados em um item principal, todos atribuídos ao mesmo uso. Isso ocorrerá se apenas um uso for especificado para um item principal cuja contagem de relatórios é maior que uma.

A figura a seguir mostra um exemplo de uma matriz de valor de uso que contém cinco itens de dados, cada um com seis bits de comprimento.

No exemplo anterior, a estrutura de capacidade de valor para essa matriz de valor de uso teria seu membro IsRange definido como FALSE, seu membro NotRange.Usage definido como 17, seu membro ReportCount definido como 5 e seu membro BitSize definido como 6.

Se a contagem de relatórios para uma utilização for 1, use HidP_GetUsageValue para extrair o valor da utilização. Se a contagem de relatórios do uso for maior que 1, HidP_GetUsageValue retornará apenas o primeiro item de dados em uma matriz de valor de uso. Para extrair todos os itens de dados em uma matriz de valor de uso, use HidP_GetUsageValueArray.