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
指定位於 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 值。 |
言論
調整值是指未經調整的原始 HID 數據的輸出，這些輸出會根據特定參數修改，例如敏感度和裝置的範圍。 這項調整可讓您更有意義地解譯與裝置預定用途相關的數據。
如需進一步瞭解 HID 報表的解譯方式和縮放值的重要性，請參閱 解譯 HID 報表。
HidP_SetScaledUsageValue 設定符號位。
如果例程傳回HIDP_STATUS_INCOMPATIBLE_REPORT_ID，則指定的報表會包含使用方式。 不過，使用者模式應用程式或內核模式驅動程式可以在零初始化報表中設定使用量。 請參閱 初始化 HID 報表。
如需詳細資訊，請參閱 HID 集合。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows 2000 和更新版本的 Windows。 |
| 目標平臺 | 普遍 |
| 標頭 | hidpi.h （包括 Hidpi.h） |
| 連結庫 | Hidparse.lib |
| IRQL | <= DISPATCH_LEVEL |