função HidP_GetValueCaps (hidpi.h)
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 |
|---|---|
|
A rotina retornou com êxito os dados de funcionalidade. |
|
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 |