跳轉到主要內容
擷取裝置上力回饋馬達的相關資訊,例如其支援的軸和效果類型。

語法

參數

infoArrayCount   _In_
類型:uint32_t
infoArray 中的元素數目。若要擷取所有力回饋馬達,請傳遞 GetForceFeedbackMotorCount 傳回的值。 infoArray   _Out_writes_to_opt_(infoArrayCount, return)
類型:GameInputForceFeedbackMotorInfo*
指向陣列的指標,此陣列會針對每個力回饋馬達接收一個結構。可以是 nullptr,在此情況下不會寫入任何內容,且方法會傳回 0。

傳回值

類型:uint32_t 寫入 infoArray 的元素數目。此值為 infoArrayCount 與裝置上力回饋馬達數目兩者中的較小值;如果 infoArray 為 nullptr 或裝置沒有力回饋馬達,則為 0。

備註

每個元素都是一個 GameInputForceFeedbackMotorInfo 結構,描述對應馬達所驅動的軸及其支援的力回饋效果類型。 呼叫 GetForceFeedbackMotorCount 以取得力回饋馬達數目,配置該大小的陣列,然後呼叫 GetForceFeedbackMotorInfo 加以填入。如果 infoArrayCount 小於力回饋馬達數目,則只會寫入前 infoArrayCount 個元素。在裝置連線期間,裝置的力回饋馬達不會變更,因此您可以只查詢一次並快取結果。 資訊陣列的元素 i 描述馬達索引為 i 的馬達。將該索引當作 CreateForceFeedbackEffect、IsForceFeedbackMotorPoweredOn 和 SetForceFeedbackMotorGain 的 motorIndex 參數使用。 下列範例示範如何擷取裝置的力回饋馬達。
在 GameInput v3 及更早版本中,此資訊可從 IGameInputDevice::GetDeviceInfo 所傳回 GameInputDeviceInfo 結構的 forceFeedbackMotorInfo 成員取得。

需求

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

另請參閱

GameInput 概觀
GetForceFeedbackMotorCount
GameInputForceFeedbackMotorInfo
CreateForceFeedbackEffect
IsForceFeedbackMotorPoweredOn
SetForceFeedbackMotorGain
GameInput 上的力回饋
IGameInputDevice

版本歷程記錄

最後修改於 2026年11月6日