HidP_SetScaledUsageValue 函数 (hidpi.h)

项目
02/29/2024

HidP_SetScaledUsageValue例程将有符号和缩放的物理数字转换为 HID 用法的逻辑值，并在指定的 HID 报表中设置使用值。

语法

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
);

参数

[in] ReportType

指定一个 HIDP_REPORT_TYPE 枚举器值，该值指示位于 Report 中的 HID 报表的类型。

[in] UsagePage

指定使用情况的使用情况页。

[in] LinkCollection

指定包含用法的链接集合。如果 LinkCollection 为非零值，则例程仅设置此链接集合中的用法（如果存在）。如果 LinkCollection 为零，则例程将设置它在与 PreparsedData 关联的顶级集合中找到的第一个用法。

[in] Usage

指定用法。

[in] UsageValue

指定有符号和缩放的物理数，例程将其转换为用法的逻辑值。

[in] PreparsedData

指向顶级预分析数据的指针。

[in, out] Report

指向 HID 报表的指针。

[in] ReportLength

指定位于 Report 的 HID 报表的大小（以字节为单位），该大小必须等于集合HIDP_CAPS结构中 HidP_GetCaps 返回的指定报表类型的报表长度。

返回值

HidP_SetScaledUsageValue 返回以下状态值之一：

返回代码	说明
HIDP_STATUS_SUCCESS	例程已成功设置使用值。
HIDP_STATUS_BAD_LOG_PHY_VALUES	用法具有阻止缩放的非法逻辑或物理范围。
HIDP_STATUS_VALUE_OUT_OF_RANGE	指定的物理值在范围外，并且用法没有 null 值。
HIDP_STATUS_INVALID_REPORT_LENGTH	报表长度无效。
HIDP_STATUS_INVALID_REPORT_TYPE	指定的报表类型无效。
HIDP_STATUS_INCOMPATIBLE_REPORT_ID	指定报表中不存在用法，但它确实存在于指定类型的其他报表中。
HIDP_STATUS_INVALID_PREPARSED_DATA	预分析的数据无效。
HIDP_STATUS_USAGE_NOT_FOUND	指定报表类型的任何报表中都不存在此用法。
HIDP_STATUS_NULL	指定的物理值在范围外，用法具有 null 值，例程设置 null 值。

注解

HidP_SetScaledUsageValue 设置符号位。

如果例程返回HIDP_STATUS_INCOMPATIBLE_REPORT_ID，则指定的报表确实包含使用情况。但是，用户模式应用程序或内核模式驱动程序可以在零初始化报表中设置使用情况。请参阅初始化 HID 报表。

有关详细信息，请参阅 HID 集合。

要求

要求	值
最低受支持的客户端	在 Windows 2000 和更高版本的 Windows 中可用。
目标平台	通用
标头	hidpi.h (包括 Hidpi.h)
Library	Hidparse.lib
IRQL	<= DISPATCH_LEVEL