función HidP_GetSpecificValueCaps (hidpi.h)

Artículo
02/07/2025

La rutina HidP_GetSpecificValueCaps devuelve una matriz de funcionalidad de valor que describe todos los valores de control HID que cumplen los criterios de selección especificados.

Sintaxis

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

[in] UsagePage

Especifica una página de uso como criterios de búsqueda. Si usagePage es distinto de cero, solo se devuelven los valores que especifican esta página de uso.

[in] LinkCollection

Especifica un colección de vínculos como criterios de búsqueda. Si linkCollection es distinto de cero, solo se devuelven los valores que forman parte de esta colección de vínculos.

[in] Usage

Especifica un de uso de HID de como criterios de búsqueda. Si usage es distinto de cero, solo se devolverán los valores que especifican este uso.

[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 de la entrada, en los elementos de matriz, del búfer proporcionado en ValueCaps. En la salida, este parámetro se establece en el número de elementos que la rutina devuelve realmente.

[in] PreparsedData

Puntero a un colección de nivel superior datos preparados.

Valor devuelto

HidP_GetSpecificValueCaps devuelve uno de los siguientes valores de estado:

Código devuelto	Valor de estado de NT	Descripción
HIDP_STATUS_SUCCESS	0x00110000	La rutina devolvió correctamente los datos de funcionalidad.
HIDP_STATUS_INVALID_PREPARSED_DATA	0xc0110001	Los datos preparados no son válidos.
HIDP_STATUS_USAGE_NOT_FOUND	0xc0110004	El uso no existe en ningún informe del tipo de informe especificado.

Observaciones

El tamaño necesario del búfer de ValueCaps especifica el NumberXxxValueCaps miembros de la estructura HIDP_CAPS de una colección de nivel superior.

Al llamar a HidP_GetSpecificValueCaps, especificar cero para UsagePage, Usagey LinkCollection equivale a llamar a HidP_GetValueCaps.

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	PASSIVE_LEVEL

Consulte también

Compartir a través de