HidP_SetScaledUsageValue函数 （hidpi.h）
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 枚举器值，该值指示位于 报表的 HID 报表的类型。
[in] UsagePage
指定使用情况 使用情况页。
[in] LinkCollection
指定包含用法的 链接集合。 如果 LinkCollection 为非零，则例程仅设置此链接集合中的用法（如果存在）。 如果 LinkCollection 为零，则例程将设置它在与 PreparsedData关联的 顶级集合 中查找的第一个用法。
[in] Usage
指定用法。
[in] UsageValue
指定有符号和缩放的物理数，例程将转换为使用情况的逻辑值。
[in] PreparsedData
指向顶级 预分析数据的指针。
[in, out] Report
指向 HID 报表的指针。
[in] ReportLength
指定位于报表 报表的 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 值。 |
言论
缩放值是指根据特定参数（如敏感度和设备范围）修改的原始 HID 数据的调整输出。 此调整允许对设备预期使用的数据进行更有意义的解释。
若要进一步了解 HID 报表的解释方式和缩放值的重要性，请参阅 解释 HID 报告。
HidP_SetScaledUsageValue 设置符号位。
如果例程返回HIDP_STATUS_INCOMPATIBLE_REPORT_ID，则指定的报表包含使用情况。 但是，用户模式应用程序或内核模式驱动程序可以在零初始化的报表中设置使用情况。 请参阅 初始化 HID 报表。
有关详细信息，请参阅 HID 集合。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 在 Windows 2000 及更高版本的 Windows 中可用。 |
| 目标平台 | 普遍 |
| 标头 | hidpi.h （包括 Hidpi.h） |
| 库 | Hidparse.lib |
| IRQL | <= DISPATCH_LEVEL |