HidP_GetSpecificValueCaps函式（hidpi.h）

發行項
02/07/2025

HidP_GetSpecificValueCaps 例程會傳回值功能數位，描述符合指定選取準則的所有 HID 控制項值。

語法

NTSTATUS HidP_GetSpecificValueCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USAGE                UsagePage,
  [in]      USHORT               LinkCollection,
  [in]      USAGE                Usage,
  [out]     PHIDP_VALUE_CAPS     ValueCaps,
  [in, out] PUSHORT              ValueCapsLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData
);

參數

[in] ReportType

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

[in] UsagePage

指定使用頁面做為搜尋準則。如果 UsagePage 為非零值，則只會傳回指定此使用頁面的值。

[in] LinkCollection

指定連結集合做為搜尋準則。如果 LinkCollection 為非零值，則只會傳回屬於此連結集合的值。

[in] Usage

指定 HID 使用方式做為搜尋準則。如果 Usage 為非零值，則只會傳回指定此使用量的值。

[out] ValueCaps

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

[in, out] ValueCapsLength

指定 ValueCaps所提供緩衝區之陣列元素的輸入長度。在輸出中，此參數會設定為例程實際傳回的項目數目。

[in] PreparsedData

最上層集合預先剖析資料的指標。

傳回值

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

傳回碼	NT 狀態值	描述
HIDP_STATUS_SUCCESS	0x00110000	例程已成功傳回功能數據。
HIDP_STATUS_INVALID_PREPARSED_DATA	0xc0110001	預先剖析的數據無效。
HIDP_STATUS_USAGE_NOT_FOUND	0xc0110004	使用方式不存在於指定之報表類型的任何報表中。

言論

ValueCaps 緩衝區的必要大小是由最上層集合 HIDP_CAPS 結構 NumberXxxValueCap s 成員所指定。

呼叫 HidP_GetSpecificValueCaps時，UsagePage、Usage和 LinkCollection 指定零相當於呼叫 HidP_GetValueCaps。

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

請參閱 HID 集合。

要求

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