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

# CreateForceFeedbackEffect

> CreateForceFeedbackEffect

# CreateForceFeedbackEffect

使用 [IGameInputForceFeedbackEffect](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/igameinputforcefeedbackeffect.md) 接口来跟踪作用于电机上的力反馈效果。

## 语法

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

### 参数

*motorIndex*   \_In\_\
类型:uint32\_t

受力反馈效果影响的电机索引。

*params*   \_In\_\
类型:[GameInputForceFeedbackParams\*](https://docs.xbox.com/zh-CN/reference/input/gameinput/structs/gameinputforcefeedbackparams.md)

定义力反馈效果性质的参数。

*effect*   \_COM\_Outptr\_\
类型:IGameInputForceFeedbackEffect\*\*

生成的 [IGameInputForceFeedbackEffect](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/igameinputforcefeedbackeffect.md) 接口，用于跟踪该效果解析后的生命周期。

### 返回值

类型:HRESULT

若硬件资源不足以创建该效果，或硬件不支持所请求的效果，则此函数返回错误结果。

## 注解

`CreateForceFeedbackEffect` 方法使用 `IGameInputForceFeedbackEffect` 接口来跟踪作用于电机上的力反馈效果。如果被跟踪设备在反馈效果结束前断开连接，则该生命周期反馈效果将变为孤立状态，并会将其状态报告为"stopped"（已停止），直到相关资源被释放。有关更多信息，请参见 [GameInput 概述](https://docs.xbox.com/zh-CN/build/core-features/common/input/overviews/input-overview.md)。

## 要求

**头文件:** GameInput.h

[GameInput](https://docs.xbox.com/zh-CN/reference/input/gameinput/gameinput_members.md)\
[IGameInputDevice](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## 版本历史

| 版本 | 变更 |
| - | - |
| **v0** | 引入。 |


## Related topics

- [GameInput 力反馈](https://docs.xbox.com/zh-CN/build/core-features/common/input/hardware/input-hardware-force-feedback.md)
- [GameInput 上的力反馈](https://docs.xbox.com/zh-CN/build/core-features/common/input/advanced/input-forcefeedback.md)
- [GameInputForceFeedbackEffectKind](https://docs.xbox.com/zh-CN/reference/input/gameinput/enums/gameinputforcefeedbackeffectkind.md)
- [IGameInputForceFeedbackEffect::SetState](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_setstate.md)
- [IGameInputForceFeedbackEffect::GetGain](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_getgain.md)