HidP_GetUsages

9/8/2008

Essa função retorna uma lista de usos de botão controle HID que estão em uma página de uso especificado e estão definidos como em um relatório HID.

Syntax

NTSTATUS HidP_GetUsages(
  HIDP_REPORT_TYPE ReportType,
  USAGE UsagePage,
  USHORT LinkCollection,
  USAGE* UsageList,
  ULONG* UsageLength,
  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 de usos de botão. A função retorna apenas informações sobre botões nessa página de uso

• LinkCollection
  [no] Opcional. Vincular coleção de usos de botão. Se LinkCollection é diferente de zero, a função só retornará informações sobre os botões que contém essa coleção link; caso contrário, se LinkCollection for zero, a função retorna informações sobre todos os botões de de alto nível coleção associado com PreparsedData.

• UsageList
  [out] Ponteiro para uma reserva Caller-allocated que usa a função para retornar os usos de todos os botões que estão definidos como No e pertencem a página a uso especificada pelo UsagePage.

• UsageLength
  [in, Out] Na entrada, o comprimento em elementos de matriz a UsageList reserva. Na saída, o número de botões definido como On na página de uso especificado.

• PreparsedData
  [no] Ponteiro para uma de alto nível preparsed da coleção dados.

• Relatório
  [no] Ponteiro para um relatório.

• 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 todos os usos botão configurados para ativado.
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_BUFFER_TOO_SMALL	Na página a uso especificadoUsageList, reserva é muito pequeno para conter todos os os usos que estão atualmente definidos como ON.
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.

Remarks

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

Usuário - modo aplicativos e kernel - modo drivers chamar HidP_MaxUsageListLength Para determinar o número máximo de botões que essa função pode retornar para um tipo relatório especificado. Como alternativa, aplicativos ou drivers podem chamar HidP_GetButtons e defina UsageList Para zero para retornar o exigido comprimento em UsageLength.

Aplicativos ou drivers determinam o exigido comprimento relatório a partir de XXXReportByteLength Membros em uma de alto nível da coleção HIDP_CAPS estrutura.

Requirements

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

See Also

Reference

HIDP_CAPS
HidP_GetButtons
HidP_GetButtonsEx
HidP_GetCaps
HidP_GetScaledUsageValue
HidP_GetUsagesEx
HidP_GetUsageValue
HidP_GetUsageValueArray
HidP_MaxUsageListLength
HIDP_REPORT_TYPE