HidP_SetUsageValue

9/8/2008

Essa função define um valor controle HID em um relatório HID especificado.

Syntax

NTSTATUS HidP_SetUsageValue(
  HIDP_REPORT_TYPE ReportType,
  USAGE UsagePage,
  USHORT LinkCollection,
  USAGE Usage,
  ULONG UsageValue,
  PHIDP_PREPARSED_DATA PreparsedData,
  PCHAR Report,
  ULONG ReportLength
);

Parameters

• ReportType
  [no] HIDP_REPORT_TYPE enumerador valor que indica o tipo de relatório HID localizado em Relatório.

• UsagePage
  [no] Página de uso de um uso.

• LinkCollection
  [no] Link coleção que contém o uso. Se LinkCollection é diferente de zero, a função apenas define o uso, se houver um, esta coleção link. Se LinkCollection for zero, a função define o primeiro uso-localiza na de alto nível coleção associado com PreparsedData.

• O uso
  [no] O uso.

• UsageValue
  [no] Valor de uso.

• PreparsedData
  [no] Ponteiro para uma parte superior-preparsed do nível dados.

• Relatório
  [in, Out] Na entrada, um relatório HID inicializada. Na saída, um ponteiro para um relatório HID.

• ReportLength
  [no] Tamanho, em bytes, do relatório HID localizado em Relatório, que deve ser igual ao tamanho de relatório para o tipo especificado relatório que HidP_GetCaps Retorna do uma coleção HIDP_CAPS estrutura.

Return Value

A seguinte tabela mostra os possíveis valores de retorno.

Valor	Descrição
HIDP_STATUS_SUCCESS	A função foi definido com êxito o valor de uso.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID	O uso não consta o relatório especificado, mas ele existe em um relatório diferente do tipo especificado.
HIDP_STATUS_INVALID_PREPARSED_DATA	Dados preparsed não não válido.
HIDP_STATUS_REPORT_DOES_NOT_EXIST	Há relatórios do tipo especificado existem.
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.
HIDP_STATUS_INVALID_REPORT_LENGTH	Comprimento de relatório não é válido.
HIDP_STATUS_INVALID_REPORT_TYPE	Especificado tipo relatório não é válido.

Remarks

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

HidP_SetUsageValue Não assinar o valor. Um cliente HID deve assinar o valor na posição fornecida na HIDP_VALUE_CAPS estrutura para este valor, ou chamar HidP_SetScaledUsageValue.

Requirements

Header	hidpi.h
Library	Hidparse_lib.lib
Windows Embedded CE	Windows CE .NET 4.2 and later

See Also

Reference

HIDP_CAPS
HidP_GetCaps
HIDP_REPORT_TYPE
HidP_SetScaledUsageValue
HIDP_VALUE_CAPS