語法
參數
info _Out_類型:GameInputGamepadInfo* 指向
GameInputGamepadInfo 結構的指標,此結構會接收裝置的遊戲台屬性。如果裝置不支援遊戲台輸入,結構的每個成員都會設定為零。
傳回值
類型:bool 如果裝置支援遊戲台輸入且已填入 info,則為true;否則為 false。
備註
GetGamepadInfo 方法會將裝置的遊戲台屬性複製到呼叫端提供的結構中。當 GetSupportedInput 傳回的值包含 GameInputKindGamepad 時,裝置即支援遊戲台輸入。如果裝置不支援遊戲台輸入,GetGamepadInfo 會將 info 初始化為零並傳回 false。
supportedLayout 成員是 GameInputGamepadButtons 旗標的組合,用來識別裝置具有哪些標準遊戲台按鈕。標籤成員以 GameInputLabel 值描述對應控制項上印製的標記,讓您可以在 UI 中顯示相符的提示。extraButtonCount 和 extraAxisCount 成員會回報裝置在標準遊戲台對應之外還有多少個控制器按鈕和軸;請使用 GetExtraButtonIndexes 和 GetExtraAxisIndexes 在讀數的控制器狀態中找出它們。遊戲台狀態是使用 IGameInputReading::GetGamepadState 從讀數中讀取。
此方法傳回的屬性在裝置的存留期間內固定不變,因此您可以只查詢一次 (例如,在裝置連線時) 並快取結果。
下列範例示範如何查詢裝置的遊戲台屬性。
gamepadInfo 成員取得。
需求
標頭: GameInput.h 程式庫: gameinput.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機另請參閱
GameInput 概觀GameInputGamepadInfo
GetSupportedInput
GameInputKind
GameInputGamepadButtons
GameInputLabel
IGameInputReading::GetGamepadState
IGameInputDevice
