função HidP_GetSpecificValueCaps (hidpi.h)

Artigo
02/07/2025

A rotina de HidP_GetSpecificValueCaps retorna uma matriz de funcionalidade de valor que descreve todos os valores de controle HID que atendem a um critério de seleção especificado.

Sintaxe

NTSTATUS HidP_GetSpecificValueCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USAGE                UsagePage,
  [in]      USHORT               LinkCollection,
  [in]      USAGE                Usage,
  [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.

[in] UsagePage

Especifica uma página de uso como critérios de pesquisa. Se UsagePage não for zero, somente os valores que especificam essa página de uso serão retornados.

[in] LinkCollection

Especifica uma coleção de links como um critério de pesquisa. Se linkCollection não for zero, somente os valores que fazem parte dessa coleção de links serão retornados.

[in] Usage

Especifica um de uso de HID como critério de pesquisa. Se Uso não for zero, somente valores que especificam esse uso serão retornados.

[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 fornecido em ValueCaps. Na saída, esse parâmetro é definido como o número de elementos que a rotina realmente retorna.

[in] PreparsedData

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

Valor de retorno

HidP_GetSpecificValueCaps retorna um dos seguintes valores de status:

Código de retorno	Valor do status NT	Descrição
HIDP_STATUS_SUCCESS	0x00110000	A rotina retornou com êxito os dados de funcionalidade.
HIDP_STATUS_INVALID_PREPARSED_DATA	0xc0110001	Os dados pré-parados não são válidos.
HIDP_STATUS_USAGE_NOT_FOUND	0xc0110004	O uso não existe em nenhum relatório do tipo de relatório especificado.

Observações

O tamanho necessário do buffer ValueCaps é especificado pelo NumberXxxValueCaps membros da estrutura de HIDP_CAPS de uma coleção de nível superior.

Ao chamar HidP_GetSpecificValueCaps, especificar zero para UsagePage, Usagee LinkCollection é equivalente a chamar HidP_GetValueCaps.

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	PASSIVE_LEVEL

Consulte também

Partilhar via