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

Utilise l'interface [IGameInputForceFeedbackEffect](/fr-CA/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/igameinputforcefeedbackeffect) pour suivre l'effet de retour de force agissant sur un moteur.

## Syntaxe

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

### Paramètres

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

Index du moteur touché par l'effet de retour de force.

*params*   \_In\_\
Type : [GameInputForceFeedbackParams\*](/fr-CA/reference/input/gameinput/structs/gameinputforcefeedbackparams)

Paramètres qui définissent la nature de l'effet de retour de force.

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

L'interface [IGameInputForceFeedbackEffect](/fr-CA/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/igameinputforcefeedbackeffect) résultante, qui suit la durée de vie de la résolution de l'effet.

### Valeur de retour

Type : HRESULT

Cette fonction retourne un résultat d'erreur si les ressources matérielles sont insuffisantes pour créer l'effet, ou si l'effet demandé n'est pas pris en charge par le matériel.

## Remarques

La méthode `CreateForceFeedbackEffect` utilise l'interface `IGameInputForceFeedbackEffect` pour suivre l'effet de retour de force agissant sur un moteur. Si l'appareil suivi est déconnecté avant la fin de l'effet de rétroaction, l'effet de rétroaction devient orphelin et signale son état comme « arrêté » jusqu'à ce que les ressources soient libérées. Pour plus de renseignements, consultez [Vue d'ensemble de GameInput](/fr-CA/build/core-features/common/input/overviews/input-overview).

## Configuration requise

**En-tête :** GameInput.h

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

## Historique des versions

| Version | Modifications |
| - | - |
| **v0** | Introduit. |


## Related topics

- [CreateForceFeedbackEffect](/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_createforcefeedbackeffect.md)
- [Force feedback on GameInput](/build/core-features/common/input/advanced/input-forcefeedback.md)
- [GameInput force feedback interface](/build/core-features/common/input/hardware/input-hardware-force-feedback.md)
- [GameInputForceFeedbackConstantParams](/reference/input/gameinput/structs/gameinputforcefeedbackconstantparams.md)
- [Force feedback en GameInput](/es/build/core-features/common/input/advanced/input-forcefeedback.md)