跳轉到主要內容
擷取裝置的賽車方向盤屬性,例如其控制項標籤、踏板、排檔桿和最大方向盤角度。

語法

參數

info   _Out_
類型:GameInputRacingWheelInfo*
指向 GameInputRacingWheelInfo 結構的指標,此結構會接收裝置的賽車方向盤屬性。如果裝置不支援賽車方向盤輸入,結構的每個成員都會設定為零。

傳回值

類型:bool 如果裝置支援賽車方向盤輸入且已填入 info,則為 true;否則為 false。

備註

GetRacingWheelInfo 方法會將裝置的賽車方向盤屬性複製到呼叫端提供的結構中。當 GetSupportedInput 傳回的值包含 GameInputKindRacingWheel 時,裝置即支援賽車方向盤輸入。如果裝置不支援賽車方向盤輸入,GetRacingWheelInfo 會將 info 初始化為零並傳回 false。 hasClutch、hasHandbrake 和 hasPatternShifter 成員會回報具有哪些選用控制項,minPatternShifterGear 和 maxPatternShifterGear 提供 H 型排檔桿的檔位範圍,而 maxWheelAngle 則提供方向盤的最大旋轉角度。標籤成員以 GameInputLabel 值描述對應控制項上印製的標記,讓您可以在 UI 中顯示相符的提示。extraButtonCount 和 extraAxisCount 成員會回報裝置在標準賽車方向盤對應之外還有多少個控制器按鈕和軸;請使用 GetExtraButtonIndexes 和 GetExtraAxisIndexes 在讀數的控制器狀態中找出它們。賽車方向盤狀態是使用 IGameInputReading::GetRacingWheelState 從讀數中讀取。 此方法傳回的屬性在裝置的存留期間內固定不變,因此您可以只查詢一次 (例如,在裝置連線時) 並快取結果。 下列範例示範如何查詢裝置的賽車方向盤屬性。
在 GameInput v3 及更早版本中,此資訊可從 IGameInputDevice::GetDeviceInfo 所傳回 GameInputDeviceInfo 結構的 racingWheelInfo 成員取得。

需求

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

另請參閱

GameInput 概觀
GameInputRacingWheelInfo
GetSupportedInput
GameInputKind
GameInputLabel
IGameInputReading::GetRacingWheelState
IGameInputDevice

版本歷程記錄

最後修改於 2026年11月6日