Skip to main content

GetHapticInfo

提供有關輸入裝置完整觸覺屬性和功能的動態資訊。

語法

參數

info   _Out_
類型:GameInputHapticInfo*
包含目前裝置之觸覺中繼資料的結構。

傳回值

類型:HRESULT 如果目前裝置的觸覺功能尚未就緒 (或因其他原因無法使用),則傳回 GAMEINPUT_E_HAPTIC_NOT_FOUND。

備註

GetHapticInfo 方法會查詢目前裝置的觸覺中繼資料。由於觸覺功能依賴 Windows 音訊堆疊,因此在裝置抵達時可能尚無法取得此資訊。強烈建議您不要在裝置連線時呼叫 GetHapticInfo 方法,而是註冊裝置回呼並等候 GameInputDeviceHapticInfoReady 裝置狀態通知。這麼做可確保支援觸覺功能的裝置在被輪詢中繼資料之前,有足夠的時間初始化必要的資源。

需求

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

另請參閱

GameInput 概觀
GameInputHapticInfo
RegisterDeviceCallback
GameInputDeviceStatus
IGameInputDevice

版本歷程記錄

Last modified on October 6, 2026