跳轉到主要內容

GetExtraButtonIndexes

取得裝置上針對指定輸入類型之額外按鈕的控制器按鈕索引。

語法

參數

inputKind   _In_
類型:GameInputKind
要求其額外按鈕索引的輸入類型。 extraButtonCount   _In_
類型:uint32_t
額外按鈕之按鈕索引的預期數目。 此數目可透過呼叫 GetExtraButtonCount 擷取。 extraButtonIndexes   _Out_writes_(extraButtonCount)_
類型:uint8_t*
指向按鈕索引陣列的指標。

傳回值

類型:HRESULT 函式結果。

備註

額外按鈕是存在於實體裝置上、但不屬於指定輸入類型之標準對應的控制器按鈕。 呼叫此方法之前,您應該先呼叫 GetExtraButtonCount 以判斷有多少額外按鈕可用,並將該數目當作 extraButtonCount 參數傳遞。 下列程式碼片段示範如何使用遊戲台的額外按鈕:

需求

標頭: GameInput.h 程式庫: gameinput.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

GameInputKind
GetExtraButtonCount
GetExtraAxisIndexes
IGameInputDevice

版本歷程記錄

最後修改於 2026年10月6日