HidP_GetSpecificValueCaps函式 (hidpi.h)
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 狀態值 | Description |
|---|---|---|
|
|
例程已成功傳回功能數據。 |
|
|
預先剖析的數據無效。 |
|
|
使用方式不存在於指定之報表類型的任何報表中。 |
備註
ValueCaps 緩衝區的必要大小是由最上層集合HIDP_CAPS結構的 NumberXxxValueCaps 成員所指定。
呼叫 HidP_GetSpecificValueCaps時，針對 UsagePage、 Usage和 LinkCollection 指定零相當於呼叫 HidP_GetValueCaps。
如需集合功能的詳細資訊，請參閱 取得集合資訊。
另請參閱 HID 集合。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows 2000 和更新版本的 Windows。 |
| 目標平台 | Universal |
| 標頭 | hidpi.h (包含 Hidpi.h) |
| 程式庫 | Hidparse.lib |
| IRQL | PASSIVE_LEVEL |