función HidP_GetValueCaps (hidpi.h)

Artículo
02/07/2025

La rutina HidP_GetValueCaps devuelve una matriz de funcionalidad de valor que describe todos los valores de control HID de una colección de nivel superior para un tipo especificado de informe HID.

Sintaxis

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 un valor de enumerador HIDP_REPORT_TYPE que identifica el tipo de informe.

[out] ValueCaps

Puntero a un búfer asignado por el autor de la llamada en el que la rutina devuelve una matriz de funcionalidad de valor para el tipo de informe especificado.

[in, out] ValueCapsLength

Especifica la longitud, en la entrada, en los elementos de matriz, del búfer de ValueCaps . En la salida, la rutina establece ValueCapsLength al número de elementos que devuelve realmente.

[in] PreparsedData

Puntero a la datos preparados de una colección de nivel superior.

Valor devuelto

HidP_GetValueCaps devuelve uno de los siguientes valores de estado:

Código devuelto	Descripción
HIDP_STATUS_SUCCESS	La rutina devolvió correctamente los datos de funcionalidad.
HIDP_STATUS_INVALID_PREPARSED_DATA	Los datos preparados no son válidos.

Observaciones

La longitud correcta de valueCapsLength se especifica mediante la NumberXxxValueCaps miembros de la estructura HIDP_CAPS de una colección de nivel superior.

Para obtener más información sobre la funcionalidad de una colección, vea Obtener información de recopilación.

Consulte también colecciones HID.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Windows 2000 y versiones posteriores de Windows.
de la plataforma de destino de	Universal
encabezado de	hidpi.h (incluya Hidpi.h)
biblioteca de	Hidparse.lib
irQL	<= DISPATCH_LEVEL

Consulte también

Compartir a través de