Compartir a través de

función HidP_GetScaledUsageValue (hidpi.h)

  • Artículo

La rutina HidP_GetScaledUsageValue devuelve el resultado firmado y escalado de un valor de control HID extraído de un informe HID.

Sintaxis

NTSTATUS HidP_GetScaledUsageValue(
  [in]  HIDP_REPORT_TYPE     ReportType,
  [in]  USAGE                UsagePage,
  [in]  USHORT               LinkCollection,
  [in]  USAGE                Usage,
  [out] PLONG                UsageValue,
  [in]  PHIDP_PREPARSED_DATA PreparsedData,
  [in]  PCHAR                Report,
  [in]  ULONG                ReportLength
);

Parámetros

[in] ReportType

Especifica un valor de enumerador HIDP_REPORT_TYPE que identifica el tipo de informe HID que contiene el valor de uso de HID.

[in] UsagePage

Especifica la página de uso del valor que se va a extraer.

[in] LinkCollection

Especifica el identificador de colección de vínculos del valor que se va a extraer. Un valor LinkCollection de cero identifica la colección de nivel superior.

[in] Usage

Especifica el uso del valor que se va a extraer.

[out] UsageValue

Puntero al búfer en el que la rutina devuelve el valor firmado y escalado.

[in] PreparsedData

Puntero al de datos preparados de la colección de nivel superior que generó el informe ubicado en Report.

[in] Report

Puntero al informe que contiene el uso.

[in] ReportLength

Especifica la longitud, en bytes, del informe ubicado en Informe.

Valor devuelto

HidP_GetScaledUsageValue devuelve uno de los siguientes valores de estado:

Código devuelto Descripción
HIDP_STATUS_SUCCESS La rutina devolvió correctamente el valor.
HIDP_STATUS_INVALID_REPORT_TYPE El tipo de informe especificado no es válido.
HIDP_STATUS_INVALID_REPORT_LENGTH La longitud del informe especificada no es válida.
HIDP_STATUS_BAD_LOG_PHY_VALUES La colección devolvió un valor lógico o físico no válido. Para extraer el valor devuelto por la colección, llame a HidP_GetUsageValue.
HIDP_STATUS_NULL El estado actual del valor escalado de la colección es menor que el mínimo lógico o es mayor que el máximo lógico y el valor escalado tiene un estado NULL.
HIDP_STATUS_VALUE_OUT_OF_RANGE El estado actual de los datos de valor escalado de la colección es menor que el mínimo lógico o es mayor que el máximo lógico.
HIDP_STATUS_USAGE_NOT_FOUND El uso, la página de uso o la colección de vínculos especificados no se pueden encontrar en ningún informe admitido por la colección de nivel superior especificada.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID El valor especificado no está incluido en el informe especificado, pero está incluido en otro informe admitido por la colección de nivel superior especificada.

Observaciones

Los valores escalados hacen referencia a la salida ajustada de los datos HID sin procesar, que se modifican en función de parámetros específicos, como la confidencialidad y el intervalo del dispositivo. Este ajuste permite una interpretación más significativa de los datos en relación con el uso previsto del dispositivo.

Para comprender mejor cómo se interpretan los informes HID y la importancia de los valores escalados, consulte Interpretación de informes hid.

Los búferes asignados por el autor de la llamada proporcionados en PreparsedData, UsageValuey informe deben asignarse desde un grupo no paginado.

Las aplicaciones en modo de usuario y los controladores en modo kernel deben usar HidP_GetUsageValueArray para extraer datos de una matriz de valores de uso de .

Si la rutina devuelve el estado HIDP_STATUS_BAD_LOG_PHY_VALUES, una aplicación o controlador puede llamar a HidP_GetUsageValue para extraer los datos de uso sin procesar.

Para obtener más información, consulte 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