HidP_GetButtonsEx

9/8/2008

Essa macro é um alias mnemônico para o HidP_GetUsagesEx função.

Syntax

#define HidP_GetButtonsEx(Rty, LCo, BLi, ULe, Ppd, Rep, RLe) \
        HidP_GetUsagesEx(Rty, LCo, BLi, ULe, Ppd, Rep, RLe)

Parameters

• Rty
  [no] HIDP_REPORT_TYPE valor enumerador que identifica o tipo relatório.

• LCo
  [no] 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 os botões de de alto nível coleção associado com PreparsedData.

• BLi
  [out] Ponteiro para uma reserva Caller-allocated que função usa para retornar o uso e uso identificadores página para cada botão que estiver configurado para Ativado (um).

• ULe
  [in, Out] Na entrada, o comprimento, em elementos matriz, da ButtonList reserva. Na saída, os usos número que estão atualmente definido como no relatório especificado.

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

• Representante
  [no] Ponteiro para um relatório que contém dados botão.

• RLe
  [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 retornou com êxito todos os usos botão que estejam definidos como ON.
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	UsageList reserva é muito pequeno para conter todos os usos atualmente configurados para ativado no relatório especificado.
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	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.

Chamar clientes HID 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_GetUsagesEx 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
Windows Embedded CE	Windows CE .NET 4.2 and later

See Also

Reference

HIDP_CAPS
HidP_GetCaps
HidP_GetUsagesEx
HidP_MaxUsageListLength
HIDP_REPORT_TYPE
USAGE_AND_PAGE