HidP_GetSpecificButtonCaps

9/8/2008

Essa função retorna uma matriz funcionalidade botão que descreve todos os botões controle HID um de alto nível coleção que atendem aos critérios uma seleção especificada.

Syntax

NTSTATUS HidP_GetSpecificButtonCaps(
  HIDP_REPORT_TYPE ReportType,
  USAGE UsagePage,
  USHORT LinkCollection,
  USAGE Usage,
  PULONG ButtonCapsLength,
  PHIDP_PREPARSED_DATA PreparsedData
);

Parameters

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

• UsagePage
  [no] Página de uso como um critério pesquisa. Se UsagePage é diferente de zero, essa função só retornará botões que especificar essa página de uso.

• LinkCollection
  [no] Vincular coleção como critérios pesquisa. Se LinkCollection é diferente de zero, essa função só retornará botões que fazem parte da coleção link.

• O uso
  [no] Uso HID como critérios pesquisa. Se O uso é diferente de zero, essa função só retornará botões que especificar esse uso.

• ButtonCaps
  [out] Ponteiro para uma reserva Caller-allocated no qual a função retorna uma matriz funcionalidade botão para tipo de relatório especificado.

• ButtonCapsLength
  [in, Out] Na entrada, comprimento em elementos matriz da reserva fornecida no ButtonCaps. Na saída, número de elementos que a função retornada.

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

Return Value

Retorna HIDP_STATUS_SUCCESS se a função retornado com êxito os dados funcionalidade. Retorna HIDP_STATUS_INVALID_PREPARSED_DATA se os dados preparsed não for válido.

Remarks

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

O NúmeroXXXButtonCaps membros de uma de alto nível da coleção HIDP_CAPS especificar estrutura o exigido tamanho das ButtonCaps matriz.

Chamando HidP_GetSpecificButtonCapse especificar zero para UsagePage, O uso, e LinkCollection é equivalente ao chamado HidP_GetButtonCaps.

Requirements

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

See Also

Reference

HidP_GetButtonCaps
HidP_GetCaps
HIDP_BUTTON_CAPS
HIDP_REPORT_TYPE