共用方式為

HidP_GetScaledUsageValue函式 (hidpi.h)

  • 發行項

HidP_GetScaledUsageValue例程會傳回從 HID 報表擷取之 HID 控制件值的帶正負號和縮放結果。

語法

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

參數

[in] ReportType

指定 HIDP_REPORT_TYPE 列舉值，識別包含 HID 使用量值的 HID 報表類型。

[in] UsagePage

指定要擷取之值的使用頁面。

[in] LinkCollection

指定要擷取之值的連結集合標識碼。 LinkCollection 值為零會識別最上層集合。

[in] Usage

指定要擷取之值的用法。

[out] UsageValue

例程傳回帶正負號和縮放值的緩衝區指標。

[in] PreparsedData

產生位於報表之最上層集合之預先剖析數據的指標。

[in] Report

包含使用方式之報表的指標。

[in] ReportLength

指定位於 報表的報表長度，以位元組為單位。

傳回值

HidP_GetScaledUsageValue 會傳回下列其中一個狀態值：

傳回碼 Description
HIDP_STATUS_SUCCESS
 例程已成功傳回 值。
HIDP_STATUS_INVALID_REPORT_TYPE
 指定的報表類型無效。
HIDP_STATUS_INVALID_REPORT_LENGTH
 指定的報表長度無效
HIDP_STATUS_BAD_LOG_PHY_VALUES
 集合傳回不合法的邏輯或實體值。 若要擷取集合所傳回的值，請呼叫 HidP_GetUsageValue。
HIDP_STATUS_NULL
 集合中縮放值的目前狀態小於邏輯最小值或大於邏輯最大值，而縮放值具有 NULL 狀態。
HIDP_STATUS_VALUE_OUT_OF_RANGE
 集合中縮放值數據的目前狀態小於邏輯最小值或大於邏輯最大值。
HIDP_STATUS_USAGE_NOT_FOUND
 在指定的最上層集合所支援的任何報表中，找不到指定的使用方式、使用方式頁面或連結集合。
HIDP_STATUS_INCOMPATIBLE_REPORT_ID
 指定的值不包含在指定的報表中，但包含在指定的最上層集合所支援的另一個報表中。

備註

在 PreparsedData、UsageValue 和 Report 提供的呼叫端配置緩衝區，必須從非分頁集區配置。

使用者模式應用程式和內核模式驅動程序必須使用 HidP_GetUsageValueArray 來擷取 使用值數位資料。

如果例程傳回狀態HIDP_STATUS_BAD_LOG_PHY_VALUES，應用程式或驅動程式可以呼叫 HidP_GetUsageValue 來擷取原始使用量數據。

如需詳細資訊，請參閱 HID 集合。

規格需求

需求 值
最低支援的用戶端 適用於 Windows 2000 和更新版本的 Windows。
目標平台 Universal
標頭 hidpi.h (包含 Hidpi.h)
程式庫 Hidparse.lib
IRQL <= DISPATCH_LEVEL

另請參閱

HidP_GetUsageValue

HidP_GetUsageValueArray

_HIDP_PREPARSED_DATA