HidP_GetButtonCaps函式 (hidpi.h)

  • 發行項

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

語法

NTSTATUS HidP_GetButtonCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [out]     PHIDP_BUTTON_CAPS    ButtonCaps,
  [in, out] PUSHORT              ButtonCapsLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData
);

參數

[in] ReportType

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

[out] ButtonCaps

呼叫端配置的緩衝區指標，例程會用來傳回指定報表類型的按鈕功能陣列。

[in, out] ButtonCapsLength

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

[in] PreparsedData

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

傳回值

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

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

備註

HidP_GetButtonCaps會 針對指定的報表類型傳回最上層集合中所有按鈕的功能。

ButtonCapsLength 應該設定為HidP_GetCaps傳回之HIDP_CAPS結構之 NumberXxxButtonCaps 成員的值，其中 Xxx 會指定報表類型。

若要取得按鈕功能的子集，請依 使用量、 使用量頁面或 連結集合選取，請使用 HidP_GetSpecificButtonCaps。

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

另請參閱 HID 集合。

規格需求

需求 值
最低支援的用戶端 可在 Windows 2000 和更新版本的 Windows 中使用。
目標平台 Universal
標頭 hidpi.h (包含 Hidpi.h)
程式庫 Hidparse.lib
IRQL PASSIVE_LEVEL

另請參閱

HIDP_BUTTON_CAPS

HidP_GetCaps

HidP_GetSpecificButtonCaps

_HIDP_PREPARSED_DATA