> ## 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::SetGain

> IGameInputForceFeedbackEffect::SetGain

# IGameInputForceFeedbackEffect::SetGain

在力反馈效果上设置增益。

## 语法

```cpp theme={null}
void SetGain(
    float gain
);
```

### 参数

*gain*   \_In\_\
类型:float

应用到力反馈效果的新增益。

### 返回值

无

## 注解

力反馈电机上的增益取值范围为 0.0 到 1.0。

有两种类型的增益会影响力反馈效果的强度:一种是通过 [IGameInputDevice::SetForceFeedbackMotorGain](/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setforcefeedbackmotorgain) 在电机上设置的增益，另一种是通过此函数在效果自身上设置的增益。

两种增益的效果是相乘的。如果效果增益设置为 0.5，且电机的主增益设置为 0.5，则效果将以 0.25 的强度播放。有关更多信息，请参见 [Advanced GameInput topics](/build/core-features/common/input/advanced/input-advanced-topics)。

## 要求

**头文件:** GameInput.h

[GameInput 概述](/build/core-features/common/input/overviews/input-overview)\
[IGameInputForceFeedbackEffect::GetGain](/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_getgain)\
[IGameInputDevice::SetForceFeedbackMotorGain](/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setforcefeedbackmotorgain)\
[IGameInputForceFeedbackEffect](/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/igameinputforcefeedbackeffect)

## 版本历史

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