função HidP_GetValueCaps (hidpi.h)

  • Artigo

A rotina HidP_GetValueCaps retorna uma matriz de funcionalidade de valor que descreve todos os valores de controle HID em uma coleção de nível superior para um tipo especificado de relatório HID.

Sintaxe

NTSTATUS HidP_GetValueCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [out]     PHIDP_VALUE_CAPS     ValueCaps,
  [in, out] PUSHORT              ValueCapsLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData
);

Parâmetros

[in] ReportType

Especifica um valor de enumerador HIDP_REPORT_TYPE que identifica o tipo de relatório.

[out] ValueCaps

Ponteiro para um buffer alocado pelo chamador no qual a rotina retorna uma matriz de recursos de valor para o tipo de relatório especificado.

[in, out] ValueCapsLength

Especifica o comprimento, na entrada, em elementos de matriz, do buffer ValueCaps . Na saída, a rotina define ValueCapsLength como o número de elementos que ele realmente retorna.

[in] PreparsedData

Ponteiro para os dados pré-preparados de uma coleção de nível superior.

Retornar valor

HidP_GetValueCaps retorna um dos seguintes valores de status:

Código de retorno Descrição
HIDP_STATUS_SUCCESS
 A rotina retornou com êxito os dados de funcionalidade.
HIDP_STATUS_INVALID_PREPARSED_DATA
 Os dados pré-parados não são válidos.

Comentários

O comprimento correto para ValueCapsLength é especificado pelos membros NumberXxxValueCaps da estrutura HIDP_CAPS de uma coleção de nível superior.

Para obter mais informações sobre a funcionalidade de uma coleção, consulte Obtendo informações de coleção.

Consulte também Coleções HID.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho hidpi.h (inclua Hidpi.h)
Biblioteca Hidparse.lib
IRQL <= DISPATCH_LEVEL

Confira também

HIDP_CAPS

HIDP_VALUE_CAPS

HidP_GetButtonCaps

HidP_GetCaps

_HIDP_PREPARSED_DATA