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 傳回下列其中一個狀態值:

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

言論

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

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

請參閱 HID 集合

要求

要求 價值
最低支援的用戶端 適用於 Windows 2000 和更新版本的 Windows。
目標平臺 普遍
標頭 hidpi.h (包括 Hidpi.h)
連結庫 Hidparse.lib
IRQL <= DISPATCH_LEVEL

另請參閱

HIDP_CAPS

HIDP_VALUE_CAPS

HidP_GetButtonCaps

HidP_GetCaps

_HIDP_PREPARSED_DATA