> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateForceFeedbackEffect

> CreateForceFeedbackEffect

# CreateForceFeedbackEffect

使用 [IGameInputForceFeedbackEffect](/zh-TW/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/igameinputforcefeedbackeffect) 介面追蹤作用於馬達上的力回饋效果。

## 語法

```cpp theme={null}
HRESULT CreateForceFeedbackEffect(
    uint32_t motorIndex,
    const GameInputForceFeedbackParams* params,
    IGameInputForceFeedbackEffect** effect
);
```

### 參數

*motorIndex*   \_In\_\
類型：uint32\_t

受力回饋效果影響之馬達的索引。

*params*   \_In\_\
類型：[GameInputForceFeedbackParams\*](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackparams)

定義力回饋效果性質的參數。

*effect*   \_COM\_Outptr\_\
類型：IGameInputForceFeedbackEffect\*\*

產生的 [IGameInputForceFeedbackEffect](/zh-TW/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/igameinputforcefeedbackeffect) 介面，可追蹤效果解析的存留期。

### 傳回值

類型：HRESULT

如果硬體資源不足以建立效果，或硬體不支援要求的效果，此函式會傳回錯誤結果。

## 備註

`CreateForceFeedbackEffect` 方法會使用 `IGameInputForceFeedbackEffect` 介面追蹤作用於馬達上的力回饋效果。如果追蹤的裝置在回饋效果完成之前中斷連線，其存留期回饋效果會變成孤立狀態，並會將其狀態回報為「已停止」，直到資源釋放為止。如需詳細資訊，請參閱 [GameInput 概觀](/zh-TW/build/core-features/common/input/overviews/input-overview)。

## 需求

**標頭：** GameInput.h

[GameInput](/zh-TW/reference/input/gameinput/gameinput_members)\
[IGameInputDevice](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v0** | 已推出。 |


## Related topics

- [CreateForceFeedbackEffect](/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_createforcefeedbackeffect.md)
- [Force feedback on GameInput](/build/core-features/common/input/advanced/input-forcefeedback.md)
- [GameInput force feedback interface](/build/core-features/common/input/hardware/input-hardware-force-feedback.md)
- [GameInputForceFeedbackConstantParams](/reference/input/gameinput/structs/gameinputforcefeedbackconstantparams.md)
- [Force feedback en GameInput](/es/build/core-features/common/input/advanced/input-forcefeedback.md)