HidP_GetValueCaps函式 (hidpi.h)

  • 發行項

HidP_GetValueCaps例程會傳回一個值功能數位，描述指定之 HID 報表類型之最上層集合中的所有 HID 控制項值。

語法

NTSTATUS HidP_GetValueCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [out]     PHIDP_VALUE_CAPS     ValueCaps,
  [in, out] PUSHORT              ValueCapsLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData
);

參數

[in] ReportType

指定識別報表類型的 HIDP_REPORT_TYPE 列舉值。

[out] ValueCaps

呼叫端配置之緩衝區的指標，其中例程會針對指定的報表類型傳回值功能陣列。

[in, out] ValueCapsLength

指定 ValueCaps 緩衝區之數位元素的輸入長度。 輸出時，例程會將 ValueCapsLength 設定為實際傳回的項目數。

[in] PreparsedData

最上層集合 預先剖析數據的指標。

傳回值

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

傳回碼 Description
HIDP_STATUS_SUCCESS
 例程已成功傳回功能數據。
HIDP_STATUS_INVALID_PREPARSED_DATA
 預先剖析的數據無效。

備註

ValueCapsLength 的正確長度是由最上層集合HIDP_CAPS結構的 NumberXxxValueCaps 成員所指定。

如需集合功能的詳細資訊，請參閱 取得集合資訊。

另請參閱 HID 集合。

規格需求

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

另請參閱

HIDP_CAPS

HIDP_VALUE_CAPS

HidP_GetButtonCaps

HidP_GetCaps

_HIDP_PREPARSED_DATA