função HidP_GetValueCaps (hidpi.h)

Artigo
02/07/2025

A rotina de HidP_GetValueCaps retorna uma matriz de recursos de valor que descreve todos os valores de controle HID em uma coleção de 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 funcionalidade 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, os conjuntos de rotina ValueCapsLength para 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.

Valor de retorno

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.

Observações

O comprimento correto para ValueCapsLength é especificado pelo NumberXxxValueCaps membros da estrutura de 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
de cliente com suporte mínimo	Disponível no Windows 2000 e versões posteriores do Windows.
da Plataforma de Destino	Universal
cabeçalho	hidpi.h (inclua Hidpi.h)
biblioteca	Hidparse.lib
IRQL	<= DISPATCH_LEVEL

Consulte também

Partilhar via