HID Report Interpretation
.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
Extraindo dados do valor por especificar seu uso
A seguinte tabela mostra as funções que drivers HID cliente podem usar para extrair dados valor de um relatório HID.
| Função | Descrição |
|---|---|
Retorna um assinado e dimensionado valor. |
|
Retorna um valor nonscaled em uma sem assinatura formato ou um valor em escala que está out of seu intervalo normal. |
|
Retorna uma matriz valor de uso. Para usar HidP_GetUsageValueArray, aplicativos e drivers devem alocar uma reserva zero-initialized que é grande o suficiente para manter a matriz valor de uso. O exigido tamanho, em bytes, é o produto das BitSize e ReportCount Os membros da matriz valor de uso HIDP_VALUE_CAPS estrutura, arredondado up to o byte mais próximo. |
Extraindo usos do botão que estão definidos como on
Para extrair botão usos que estão no, você primeiro deve alocar e zero-inicializar a reserva usada para retornar a matriz de botão usos. Chamar HidP_MaxUsageListLength Para determinar o número de usos botão em uma página de uso especificado no relatório. Se o driver cliente HID especifica uma página de uso do zero, a função retornará o número de todos os usos de botão no relatório.
A seguinte tabela mostra as funções que drivers HID cliente podem usar para extrair os usos HID dos botões que estão definidos para em (1), e o exigido tamanho do buffer. Essas funções retornam uma matriz de todas as informações de uso para todos os botões que estão atualmente definidos como ON. Implicitamente, se essas funções não retornam o uso de botões, o uso é Desativado (zero).
| Função | Tamanho do buffer necessário | Descrição |
|---|---|---|
Valor retornado por HidP_MaxUsageListLengthmultiplicado por sizeof(USAGE). |
Retorna o identificador de uso de todos os botões em uma página de uso especificado que estão no. |
|
Valor retornado por HidP_MaxUsageListLengthmultiplicado por sizeof(USAGE_AND_PAGE). |
Retorna a página de uso e identificador de todos os botões que estão em uso. |
Após um driver cliente HID usa essas funções para obter informações sobre quais botões são atualmente configurados para Ativado, o driver cliente HID pode determinar a diferença entre o atual estado e o estado anterior dos botões por chamado HidP_UsageListDifference Ou HidP_UsageAndPageListDifference, que Ambas retornam a diferença entre duas matrizes de informações de uso:
Configuração de Dados do valor por especificar seu uso
A seguinte tabela mostra as funções que um driver cliente HID pode usar para definir um valor em um corretamente inicializado HID relatório.
| Função | Descrição |
|---|---|
Define um assinado e dimensionado valor em um relatório. |
|
Define um valor em um relatório. |
|
Define uma matriz valor de uso em um relatório. |
Configuração do estado do botão por especificar seu uso
A seguinte tabela mostra as funções que um driver cliente HID pode usar para definir o estado dos botões em uma corretamente inicializado HID relatório.
| Função | Descrição |
|---|---|
Define um conjunto especificado de botões como Ativado. |
|
Define um conjunto especificado de botões como Desativado. |
Extraindo e a configuração de controle de dados por dados índices
A seguinte tabela mostra as funções que um driver cliente HID pode usar com dados índices para extrair e definir controle dados em um relatório HID.
| Função | Descrição |
|---|---|
Retorna uma matriz de HIDP_DATA estruturas para um relatório especificado que identifica os índices dados de todos os botões controle HID que estão atualmente definidos como no e para os índices dados e dados associado com todos os valores controle HID. |
|
Define um conjunto especificado do controle botão e valor usos HID em um relatório HID. |
Por chamado essas funções, um driver cliente HID eficiente podem obter e definir todos os valores em um relatório. De exemplo, para obter todos os dados valor, seus usos HID, um driver cliente HID deve chamar HidP_GetUsageValue Para cada uso. No entanto, para obter todos os índice Data by Data valor, ele só deve chamar HidP_GetData Uma vez.
Use os índices dados especificados em matrizes funcionalidade botão e matrizes funcionalidade valor de uma coleção para identificar HID usos.