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

# CreateForceFeedbackEffect

> CreateForceFeedbackEffect

# CreateForceFeedbackEffect

[IGameInputForceFeedbackEffect](/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/igameinputforcefeedbackeffect) インターフェイスを使用して、モーターに作用するフォース フィードバック エフェクトを追跡します。

## 構文

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

### パラメーター

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

フォース フィードバック エフェクトの影響を受けるモーターのインデックスです。

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

フォース フィードバック エフェクトの性質を定義するパラメーターです。

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

エフェクトの解決の寿命を追跡する、生成された [IGameInputForceFeedbackEffect](/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/igameinputforcefeedbackeffect) インターフェイスです。

### 戻り値

型: HRESULT

エフェクトの作成に必要なハードウェア リソースが不足している場合、または要求されたエフェクトがハードウェアでサポートされていない場合、この関数はエラー結果を返します。

## 解説

`CreateForceFeedbackEffect` メソッドは、`IGameInputForceFeedbackEffect` インターフェイスを使用して、モーターに作用するフォース フィードバック エフェクトを追跡します。追跡対象のデバイスがフィードバック エフェクトの終了前に切断された場合、その寿命フィードバック エフェクトは孤立状態となり、リソースが解放されるまで状態は「stopped」として報告されます。詳細については、「[GameInput の概要](/build/core-features/common/input/overviews/input-overview)」を参照してください。

## 要件

**ヘッダー:** GameInput.h

[GameInput](/reference/input/gameinput/gameinput_members)\
[IGameInputDevice](/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## バージョン履歴

| バージョン  | 変更点 |
| ------ | --- |
| **v0** | 導入。 |


## Related topics

- [GameInput フォースフィードバックインターフェイス](/ja-jp/build/core-features/common/input/hardware/input-hardware-force-feedback.md)
- [GameInput のフォースフィードバック](/ja-jp/build/core-features/common/input/advanced/input-forcefeedback.md)
- [GameInputForceFeedbackEffectKind](/ja-jp/reference/input/gameinput/enums/gameinputforcefeedbackeffectkind.md)
- [IGameInputForceFeedbackEffect::SetState](/ja-jp/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_setstate.md)
- [IGameInputForceFeedbackEffect::GetGain](/ja-jp/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_getgain.md)