HidP_GetValueCaps función (hidpi.h)

Artículo
02/29/2024

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 ValueCaps . En la salida, la rutina establece ValueCapsLength en el número de elementos que devuelve realmente.

[in] PreparsedData

Puntero a los 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.

Comentarios

La longitud correcta para ValueCapsLength se especifica mediante los miembros NumberXxxValueCaps de una estructura de 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	Value
Cliente mínimo compatible	Disponible en Windows 2000 y versiones posteriores de Windows.
Plataforma de destino	Universal
Encabezado	hidpi.h (include Hidpi.h)
Library	Hidparse.lib
IRQL	<= DISPATCH_LEVEL