HidP_GetUsageValue
9/8/2008
Essa função extrai os dados associado com um valor controle HID que correspondam aos critérios seleção em um relatório HID.
Syntax
NTSTATUS HidP_GetUsageValue(
HIDP_REPORT_TYPE ReportType,
USAGE UsagePage,
USHORT LinkCollection,
USAGE Usage,
PULONG UsageValue,
PHIDP_PREPARSED_DATA PreparsedData,
PCHAR Report,
ULONG ReportLength
);
Parameters
- ReportType
[no] HIDP_REPORT_TYPE valor enumerador que identifica o tipo relatório.
- UsagePage
[no] Página de uso do valor.
- LinkCollection
[no] Link coleção que contém o valor. Se LinkCollection é diferente de zero, a função só procura o uso na coleção link; caso contrário, se LinkCollection for zero, o função procura o uso na de alto nível coleção associado com PreparsedData.
- O uso
[no] Uso do valor.
- UsageValue
[out] Ponteiro para uma reserva no qual a função retorna dados de valor.
- PreparsedData
[no] Ponteiro para uma de alto nível preparsed da coleção dados.
- Relatório
[no] Ponteiro para um relatório que contém valores.
- ReportLength
[no] Comprimento, em bytes, do relatório localizado em Relatório.
Return Value
A seguinte tabela mostra os possíveis valores de retorno.
Valor | Descrição |
---|---|
HIDP_STATUS_SUCCESS |
A função de dados valor retornado com êxito. |
HIDP_INVALID_REPORT_LENGTH |
Comprimento de relatório não é válido. |
HIDP_INVALID_REPORT_TYPE |
Especificado tipo relatório não é válido. |
HIDP_STATUS_INCOMPATIBLE_REPORT_ID |
Relatório contém uma coleção com os botões na página a uso especificado, mas há não tais usos no relatório. |
HIDP_STATUS_INVALID_PREPARSED_DATA |
Dados preparsed não não válido. |
HIDP_STATUS_USAGE_NOT_FOUND |
Coleção não contém um valor na página a uso especificado em qualquer relatório de tipo de relatório especificado. |
Remarks
Os termos botão e o uso são usados como sinônimo.
HidP_GetUsageValue Não assinar ou escalabilidade o valor. Para extrair um valor assinado, use HidP_GetScaledUsageValue. Para atribuir manualmente o bit de sinal, você pode determinar a posição do bit de sinal a partir de informações em do um valor HIDP_VALUE_CAPS estrutura.
Para extrair uma matriz valor de uso, use HidP_GetUsageValueArray.
Requirements
Header | hidpi.h |
Library | Hidparse_lib.lib |
Windows Embedded CE | Windows CE .NET 4.2 and later |
See Also
Reference
HidP_GetButtons
HidP_GetButtonsEx
HidP_GetCaps
HidP_GetScaledUsageValue
HidP_GetUsages
HidP_GetUsagesEx
HidP_GetUsageValueArray
HIDP_REPORT_TYPE
HIDP_VALUE_CAPS