跳轉到主要內容

GetExtraButtonCount

取得裝置中針對指定輸入類型存在的額外按鈕 (或不支援的按鈕) 數目。

語法

參數

inputKind   _In_
類型:GameInputKind
要求其額外按鈕數目的輸入類型。 extraButtonCount   _Out_
類型:uint32_t*
裝置中針對指定輸入類型存在的額外按鈕 (或不支援的按鈕) 數目。

傳回值

類型:HRESULT 函式結果。

備註

額外按鈕是存在於實體裝置上、但不屬於指定輸入類型之標準對應的控制器按鈕。對於想要存取超出標準輸入對應之裝置特定按鈕的應用程式而言,此方法相當實用。 取得的數目預期會與 GetExtraButtonIndexes 方法搭配使用,以擷取這些額外按鈕的特定索引,並配置正確的緩衝區空間來儲存該方法所提供的按鈕索引。

需求

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

另請參閱

GameInputKind
GetExtraButtonIndexes
GetExtraAxisCount
IGameInputDevice

版本歷程記錄

最後修改於 2026年10月6日