> ## 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.

# IGameInputForceFeedbackEffect::SetParams

> IGameInputForceFeedbackEffect::SetParams

# IGameInputForceFeedbackEffect::SetParams

为力反馈效果设置新的参数。

## 语法

```cpp theme={null}
bool SetParams(
    const GameInputForceFeedbackParams* params
);
```

### 参数

*params*   \_In\_\
类型:[GameInputForceFeedbackParams\*](/reference/input/gameinput/structs/gameinputforcefeedbackparams)

要设置的新力反馈参数。

### 返回值

类型:bool

设置新参数的结果。如果函数成功，则返回 true。

## 注解

在为力反馈效果设置新参数时，电机会尝试不中断地继续该效果。仅当新参数与旧参数共享相同的 [GameInputForceFeedbackEffectKind](/reference/input/gameinput/enums/gameinputforcefeedbackeffectkind) 枚举时，才可为该力反馈效果设置新参数。有关更多信息，请参见 [Advanced GameInput topics](/build/core-features/common/input/advanced/input-advanced-topics)。

请注意，如果 duration 值未发生变化，持续时间计时器**不会**被刷新。只有在提供不同的 duration 值，或效果被停止并重新启动时，计时器才会被刷新。

[GameInput 概述](/build/core-features/common/input/overviews/input-overview)\
[GameInputForceFeedbackParams](/reference/input/gameinput/structs/gameinputforcefeedbackparams)\
[IGameInputForceFeedbackEffect](/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/igameinputforcefeedbackeffect)

## 版本历史

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


## Related topics

- [GameInput 上的力反馈](/zh-CN/build/core-features/common/input/advanced/input-forcefeedback.md)
- [IGameInputForceFeedbackEffect::GetParams](/zh-CN/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_getparams.md)
- [IGameInputForceFeedbackEffect::SetState](/zh-CN/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_setstate.md)
- [IGameInputForceFeedbackEffect::SetGain](/zh-CN/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_setgain.md)
- [IGameInputForceFeedbackEffect::GetGain](/zh-CN/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_getgain.md)