HidP_SetScaledUsageValue

9/8/2008

Essa função converte um assinado e físico em escala número para um uso HID do valor lógico e define o valor de uso em um relatório HID especificado.

Syntax

NTSTATUS HidP_SetScaledUsageValue(
  HIDP_REPORT_TYPE ReportType,
  USAGE UsagePage, 
  USHORT LinkCollection,
  USAGE Usage,
  LONG 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] Opcional. 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] Físico assinado e dimensionado número, o qual a função converte para o valor lógico de O 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 relatório especificado que o HidP_GetCaps função 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_BAD_LOG_PHY_VALUES	Uso possui um ilegal lógico ou físico intervalo que impede o dimensionamento.
HIDP_STATUS_VALUE_OUT_OF_RANGE	Físico Especificado valor está fora - do - intervalo e o uso não tiver NULL valor.
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.
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	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_NULL	Físico Especificado valor está fora - do - intervalo, o uso tem um NULL valor e a função definiu o NULL valor.

Remarks

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

HidP_SetScaledUsageValue Define a bit de sinal.

Se a função retorna HIDP_STATUS_INCOMPATIBLE_REPORT_ID, o relatório especificado conter o uso. No entanto, um driver cliente HID pode definir o uso em um relatório zero-initialized.

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_SetUsageValue
HidP_SetUsageValueArray