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

# GameInputForceFeedbackMotorInfo

> GameInputForceFeedbackMotorInfo

# GameInputForceFeedbackMotorInfo

定義力回饋馬達資訊。

## 語法

```cpp theme={null}
struct GameInputForceFeedbackMotorInfo
{
    GameInputFeedbackAxes supportedAxes;
    bool                  isConstantEffectSupported;
    bool                  isRampEffectSupported;
    bool                  isSineWaveEffectSupported;
    bool                  isSquareWaveEffectSupported;
    bool                  isTriangleWaveEffectSupported;
    bool                  isSawtoothUpWaveEffectSupported;
    bool                  isSawtoothDownWaveEffectSupported;
    bool                  isSpringEffectSupported;
    bool                  isFrictionEffectSupported;
    bool                  isDamperEffectSupported;
    bool                  isInertiaEffectSupported;
};
```

### 成員

*supportedAxes*<br />
類型：[GameInputFeedbackAxes](/zh-TW/reference/input/gameinput/enums/gameinputfeedbackaxes)

力回饋馬達可施加力量的支援軸。

*isConstantEffectSupported*<br />
類型：bool

表示是否支援固定力回饋效果。

*isRampEffectSupported*<br />
類型：bool

表示是否支援斜坡力回饋效果。

*isSineWaveEffectSupported*<br />
類型：bool

表示是否支援正弦波力回饋效果。

*isSquareWaveEffectSupported*<br />
類型：bool

表示是否支援方波力回饋效果。

*isTriangleWaveEffectSupported*<br />
類型：bool

表示是否支援三角波力回饋效果。

*isSawtoothUpWaveEffectSupported*<br />
類型：bool

表示是否支援上升鋸齒波力回饋效果。

*isSawtoothDownWaveEffectSupported*<br />
類型：bool

表示是否支援下降鋸齒波力回饋效果。

*isSpringEffectSupported*<br />
類型：bool

表示是否支援彈簧力回饋效果。

*isFrictionEffectSupported*<br />
類型：bool

表示是否支援摩擦力回饋效果。

*isDamperEffectSupported*<br />
類型：bool

表示是否支援阻尼力回饋效果。

*isInertiaEffectSupported*<br />
類型：bool

表示是否支援慣性力回饋效果。

## 備註

`GameInputForceFeedbackMotorInfo` 結構是 [GameInputDeviceInfo](/zh-TW/reference/input/gameinput/structs/gameinputdeviceinfo) 的成員。它定義力回饋馬達的相關資訊，並使用 [GameInputFeedbackAxes](/zh-TW/reference/input/gameinput/enums/gameinputfeedbackaxes) 列舉的指標。

在現代裝置上，力回饋通常用於賽車方向盤，其中有一個單軸馬達連接到方向盤本身。不過，GameInput API 支援具有任意數量力回饋馬達的裝置，並為裝置上的每個馬達指派唯一的索引編號。"normal" 軸用於所施加的力量無維度的特殊情況，例如飛行模擬器的加壓服。

## 需求

**標頭：** GameInput.h

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 概念文件

* [GameInput 上的力回饋](/zh-TW/build/core-features/common/input/advanced/input-forcefeedback)

## 另請參閱

[GameInput 進階主題](/zh-TW/build/core-features/common/input/advanced/input-advanced-topics)\
[GameInput 概觀](/zh-TW/build/core-features/common/input/overviews/input-overview)\
[GameInputDeviceInfo](/zh-TW/reference/input/gameinput/structs/gameinputdeviceinfo)\
[GameInput](/zh-TW/reference/input/gameinput/gameinput_members)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v1** | **已移除** `location` (GameInputLocation)、`locationId` (uint32\_t) 和 `maxSimultaneousEffects` (uint32\_t)。 |
| **v0** | 推出。 |

## 附錄：先前版本

### v0

```cpp theme={null}
struct GameInputForceFeedbackMotorInfo
{
    GameInputFeedbackAxes supportedAxes;
    GameInputLocation     location;
    uint32_t              locationId;
    uint32_t              maxSimultaneousEffects;
    bool                  isConstantEffectSupported;
    bool                  isRampEffectSupported;
    bool                  isSineWaveEffectSupported;
    bool                  isSquareWaveEffectSupported;
    bool                  isTriangleWaveEffectSupported;
    bool                  isSawtoothUpWaveEffectSupported;
    bool                  isSawtoothDownWaveEffectSupported;
    bool                  isSpringEffectSupported;
    bool                  isFrictionEffectSupported;
    bool                  isDamperEffectSupported;
    bool                  isInertiaEffectSupported;
};
```


## Related topics

- [GameInputForceFeedbackMotorInfo](/reference/input/gameinput/structs/gameinputforcefeedbackmotorinfo.md)
- [Force feedback on GameInput](/build/core-features/common/input/advanced/input-forcefeedback.md)
- [Force feedback en GameInput](/es/build/core-features/common/input/advanced/input-forcefeedback.md)
- [GameInputFeedbackAxes](/ko/reference/input/gameinput/enums/gameinputfeedbackaxes.md)
- [GameInput 上的力反馈](/zh-CN/build/core-features/common/input/advanced/input-forcefeedback.md)