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

# GameInputForceFeedbackEnvelope

> GameInputForceFeedbackEnvelope

# GameInputForceFeedbackEnvelope

定義修改力回饋效果的封套。

## 語法

```cpp theme={null}
struct GameInputForceFeedbackEnvelope
{
    uint64_t attackDuration;
    uint64_t sustainDuration;
    uint64_t releaseDuration;
    float    attackGain;
    float    sustainGain;
    float    releaseGain;
    uint32_t playCount;
    uint64_t repeatDelay;
};
```

### 成員

*attackDuration*<br />
類型：uint64\_t

達到力回饋效果封套持續 (sustain) 層級所需的時間 (以微秒為單位)。

*sustainDuration*<br />
類型：uint64\_t

從持續期間開始到力回饋效果封套釋放 (release) 部分的時間 (以微秒為單位)。如果效果要無限期執行，請將此值設為 `UINT64_MAX`。

*releaseDuration*<br />
類型：uint64\_t

從持續期間到力回饋效果封套釋放的時間 (以微秒為單位)。

*attackGain*<br />
類型：float

力回饋效果封套起音 (attack) 的修飾元。

*sustainGain*<br />
類型：float

力回饋效果封套持續增益的修飾元。

*releaseGain*<br />
類型：float

力回饋效果封套釋放增益的修飾元。

*playCount*<br />
類型：uint32\_t

封套套用至力回饋事件的反覆次數。

*repeatDelay*<br />
類型：uint64\_t

每次套用力回饋封套之間的時間間隔。

## 備註

`GameInputForceFeedbackEnvelope` 是 [GameInputForceFeedbackConstantParams](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackconstantparams)、[GameInputForceFeedbackPeriodicParams](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackperiodicparams) 和 [GameInputForceFeedbackRampParams](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackrampparams) 結構的成員。力回饋封套是力回饋效果上的修飾元，可修改效果透過裝置產生的輸出。如需詳細資訊，請參閱 [GameInput 進階主題](/zh-TW/build/core-features/common/input/advanced/input-advanced-topics)。

## 需求

**標頭：** GameInput.h

## 版本歷程記錄

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


## Related topics

- [GameInputForceFeedbackEnvelope](/reference/input/gameinput/structs/gameinputforcefeedbackenvelope.md)
- [GameInputForceFeedbackConstantParams](/reference/input/gameinput/structs/gameinputforcefeedbackconstantparams.md)
- [GameInputForceFeedbackRampParams](/reference/input/gameinput/structs/gameinputforcefeedbackrampparams.md)
- [GameInputForceFeedbackPeriodicParams](/reference/input/gameinput/structs/gameinputforcefeedbackperiodicparams.md)
- [GameInput](/reference/input/gameinput/gameinput_members.md)