Compartir a través de

función HidP_SetScaledUsageValue (hidpi.h)

  • Artículo

La rutina HidP_SetScaledUsageValue convierte un número físico firmado y escalado en un valor lógico de uso de HID y establece el valor de uso en un informe HID especificado.

Sintaxis

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

Parámetros

[in] ReportType

Especifica un valor de enumerador HIDP_REPORT_TYPE que indica el tipo de informe HID ubicado en Informe.

[in] UsagePage

Especifica la página de uso de de un uso.

[in] LinkCollection

Especifica el colección de vínculos que contiene el uso. Si linkCollection es distinto de cero, la rutina solo establece el uso, si existe, en esta colección de vínculos. Si LinkCollection es cero, la rutina establece el primer uso que encuentra en la colección de nivel superior asociada a PreparsedData.

[in] Usage

Especifica el uso.

[in] UsageValue

Especifica el número físico firmado y escalado, que la rutina convierte en el valor lógico del uso.

[in] PreparsedData

Puntero a la de datos preparados de un nivel superior.

[in, out] Report

Puntero a un informe HID.

[in] ReportLength

Especifica el tamaño, en bytes, del informe HID ubicado en Informe, que debe ser igual a la longitud del informe para el tipo de informe especificado que HidP_GetCaps devuelve en la estructura HIDP_CAPS de una colección.

Valor devuelto

HidP_SetScaledUsageValue devuelve uno de los siguientes valores de estado:

Código devuelto Descripción
HIDP_STATUS_SUCCESS La rutina establece correctamente el valor de uso.
HIDP_STATUS_BAD_LOG_PHY_VALUES El uso tiene un intervalo lógico o físico no válido que impide el escalado.
HIDP_STATUS_VALUE_OUT_OF_RANGE El valor físico especificado está fuera del intervalo y el uso no tiene un valor NULL.
HIDP_STATUS_INVALID_REPORT_LENGTH La longitud del informe no es válida.
HIDP_STATUS_INVALID_REPORT_TYPE El tipo de informe especificado no es válido.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID El uso no existe en el informe especificado, pero existe en un informe diferente del tipo especificado.
HIDP_STATUS_INVALID_PREPARSED_DATA Los datos preparados no son válidos.
HIDP_STATUS_USAGE_NOT_FOUND El uso no existe en ningún informe del tipo de informe especificado.
HIDP_STATUS_NULL El valor físico especificado está fuera del intervalo, el uso tiene un valor NULL y la rutina establece el valor NULL.

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.

HidP_SetScaledUsageValue establece el bit de signo.

Si la rutina devuelve HIDP_STATUS_INCOMPATIBLE_REPORT_ID, el informe especificado contiene el uso. Sin embargo, una aplicación en modo de usuario o un controlador en modo kernel puede establecer el uso en un informe inicializado sin inicializar. Consulte Inicializar informes HID.

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