HidP_GetSpecificValueCaps

9/8/2008

Essa função retorna uma matriz funcionalidade valor que descreve todos os valores controle HID que atendem aos critérios seleção especificada.

Syntax

NTSTATUS HidP_GetSpecificValueCaps(
  HIDP_REPORT_TYPE ReportType,
  USAGE UsagePage,
  USHORT LinkCollection,
  USAGE Usage,
  PHIDP_VALUE_CAPS ValueCaps,
  PULONG ValueCapsLength,
  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 critérios pesquisa. Se UsagePage é diferente de zero, essa função só retornará valores 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á valores 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á valores que especificar esse uso.

• ValueCaps
  [out] Ponteiro para uma reserva Caller-allocated para a função para retornar uma matriz funcionalidade valor para o tipo relatório especificado.

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

• 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

O exigido tamanho das ValueCaps reserva é especificada pelo NumberXXXValueCaps membros de uma de alto nível da coleção HIDP_CAPS estrutura.

Quando chamado HidP_GetSpecificValueCaps, especificar zero para UsagePage, O uso, e LinkCollection é equivalente ao chamado HidP_GetValueCaps.

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_GetValueCaps
HIDP_REPORT_TYPE
HIDP_VALUE_CAPS