HidP_SetScaledUsageValue函式 (hidpi.h)

發行項
02/26/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 列舉值，指出位於報表的 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 傳回下列其中一個狀態值：

傳回碼	Description
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 中使用。
目標平台	Universal
標頭	hidpi.h (包含 Hidpi.h)
程式庫	Hidparse.lib
IRQL	<= DISPATCH_LEVEL