HidP_GetSpecificButtonCaps函式 (hidpi.h)
HidP_GetSpecificButtonCaps 例程會傳回 按鈕功能數位,描述符合指定選取準則之最上層集合中所有 HID 控制件 按鈕。
語法
NTSTATUS HidP_GetSpecificButtonCaps(
[in] HIDP_REPORT_TYPE ReportType,
[in] USAGE UsagePage,
[in] USHORT LinkCollection,
[in] USAGE Usage,
[out] PHIDP_BUTTON_CAPS ButtonCaps,
[in, out] PUSHORT ButtonCapsLength,
[in] PHIDP_PREPARSED_DATA PreparsedData
);
參數
[in] ReportType
指定可識別報表類型的 HIDP_REPORT_TYPE 列舉值。
[in] UsagePage
指定使用頁面做為搜尋準則。 如果 UsagePage 為非零,則只會傳回指定此使用頁面的按鈕。
[in] LinkCollection
指定 連結集合 做為搜尋準則。 如果 LinkCollection 為非零,則只會傳回屬於此連結集合的按鈕。
[in] Usage
指定 HID 使用方式 做為搜尋準則。 如果 使用量 為非零,則只會傳回指定此使用量的按鈕。
[out] ButtonCaps
呼叫端配置的緩衝區指標,其中例程會針對指定的報表類型傳回按鈕功能陣列。
[in, out] ButtonCapsLength
指定 ButtonCaps所提供緩衝區之陣列元素的輸入長度。 在輸出時,此參數會設定為例程實際傳回的項目數。
[in] PreparsedData
傳回值
HidP_GetSpecificButtonCaps 會傳回下列其中一個狀態值:
傳回碼 | 描述 |
---|---|
|
例程已成功傳回功能數據。 |
|
預先剖析的數據無效。 |
言論
ButtonCaps 陣列的必要大小是由最上層集合 HIDP_CAPS 結構成員的 NumberXxxButtonCap s 指定。
呼叫 HidP_GetSpecificButtonCaps時,針對 UsagePage、Usage指定零,而 LinkCollection 相當於呼叫 HidP_GetButtonCaps。
如需集合功能的詳細資訊,請參閱 取得集合資訊。
請參閱 HID 集合。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 適用於 Windows 2000 和更新版本的 Windows。 |
目標平臺 | 普遍 |
標頭 | hidpi.h (包括 Hidpi.h) |
連結庫 | Hidparse.lib |
IRQL | PASSIVE_LEVEL |