Skip to main content

GameInputHapticInfo

描述觸覺功能和中繼資料。

語法

成員

audioEndpointId
類型:wchar_t
WASAPI 觸覺音訊端點識別碼。 locationCount
類型:uint32_t
觸覺位置的數目。 locations
類型:GUID
觸覺位置的清單。

備註

支援觸覺的控制器與耳機或桌上型喇叭等一般用途音訊裝置非常相似;它們由 Windows 音訊系統驅動。GameInputHapticInfo 結構可讓您將觸覺音訊端點與特定的 GameInput 裝置配對。裝置回報其已就緒後,即可使用 GetHapticInfo 方法查詢此資訊。 audioEndpointId 是端點識別碼字串,可用來透過 WASAPI 或數個較高階音訊 API 中的任何一個存取觸覺裝置。開啟端點後,您只需將觸覺波形串流至裝置即可。 傳統音訊裝置的喇叭具有明確定義的位置,例如左前、右前和中央。觸覺控制器的情況則較為細微,因為裝置可能在無法妥善對應到環繞音效系統概念的實體位置支援觸覺回饋。為了將現有的音訊聲道索引調整為觸覺位置,會提供裝置特定的對應。對於支援觸覺的控制器,觸覺位置的數目一律大於零。位置清單會包含與音訊聲道索引一對一的對應。不允許重複的位置,但 GAMEINPUT_HAPTIC_LOCATION_NONE 除外,它可用來填補同時包含音訊和觸覺端點的端點。為了說明,我們來看看下列位置清單:
在此範例中,聲道 0 和 1 未使用,而聲道 2 和 3 分別對應到左握把和右握把。觸覺位置清單可能會在未來的 GameInput 版本中擴充。

需求

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

概念文件

另請參閱

GameInput 概觀
GetHapticInfo
GameInput
端點識別碼字串

版本歷程記錄

Last modified on October 6, 2026