HidP_GetUsageValueArray

9/8/2008

Essa função extrai os dados associado com uma matriz valor HID controle de uso de um relatório HID.

Syntax

NTSTATUS HidP_GetUsageValueArray(
  HIDP_REPORT_TYPE ReportType,
  USAGE UsagePage,
  USHORT LinkCollection,
  USAGE Usage,
  PCHAR UsageValue,
  USHORT UsageValueByteLength,
  PDIP_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 de matriz o valor de uso.

• LinkCollection
  [no] Opcional. Link coleção que contém a matriz valor de uso. Se LinkCollection é diferente de zero, a função só procura por uma matriz valor de uso na coleção link; caso contrário, se LinkCollection for zero, o função procura uma matriz valor de uso na de alto nível coleção associado com PreparsedData.

• O uso
  [no] Uso de matriz o valor de uso.

• UsageValue
  [out] Ponteiro para uma reserva Caller-allocated no qual a função retorna os dados associado com matriz o valor de uso.

• UsageValueByteLength
  [no] Comprimento, em bytes, da reserva em UsageValue.

• 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 retornado com êxito dados do valor.
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_NOT_VALUE_ARRAY	Uso solicitado não é uma matriz valor de uso.
HIDP_STATUS_BUFFER_TOO_SMALL	UsageValue reserva é muito pequeno para conter o uso solicitado.
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 estavam válido.
HIDP_STATUS_USAGE_NOT_FOUND	Relatório contém um uso solicitado que não esteja em qualquer relatório com suporte pela de alto nível coleção.

Remarks

Os termos botão e o uso são usados como sinônimo.

Multiplicar a BitSize e ReportCount Os membros da matriz valor de uso HIDP_VALUE_CAPS estrutura e arredondamento de resultado up to o byte mais próximo, determina o exigido tamanho de UsageValueByteLength.

Começando com o bit menos significativo de dados de uso, HidP_GetUsageValueArray Define o UsageValue reserva na ordem little-endian. Os dados não está alinhado byte e são deslocados para que o bit menos significativo de dados seja o primeiro bit das UsageValue reserva.

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_GetUsageValue
HIDP_REPORT_TYPE
HIDP_VALUE_CAPS