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

# IsForceFeedbackMotorPoweredOn

> IsForceFeedbackMotorPoweredOn

# IsForceFeedbackMotorPoweredOn

Indique si un moteur de retour de force spécifique est sous tension.

## Syntaxe

```cpp theme={null}
bool IsForceFeedbackMotorPoweredOn(
    uint32_t motorIndex
);
```

### Paramètres

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

Index du moteur de retour de force.

### Valeur de retour

Type : bool

Retourne false si le moteur de retour de force n'est pas sous tension. Retourne true si le moteur de retour de force est sous tension.

## Remarques

Les moteurs de retour de force nécessitent une source d'alimentation externe, car une connexion USB ne peut pas fournir un courant suffisant pour les entraîner. L'état d'alimentation d'un moteur n'est donc pas contrôlé par le logiciel. Il peut toutefois être signalé afin qu'une application puisse en informer l'utilisateur.

Le comportement des méthodes de retour de force de GameInput ne change pas lorsqu'un moteur n'est pas alimenté ; aucun effet ne sera donc joué par le périphérique. Fondamentalement, les API fonctionnent comme si le processus n'avait pas le focus d'entrée. Si les effets sont chargés dans un moteur de retour de force non alimenté et que le moteur est ensuite alimenté, les effets commencent à être joués comme si le processus avait obtenu le focus d'entrée. Comme pour le comportement lié au focus d'entrée, ceci vise à simplifier le modèle de programmation.

## Configuration requise

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

[GameInput](/fr/reference/input/gameinput/gameinput_members)\
[Vue d'ensemble de GameInput](/fr/build/core-features/common/input/overviews/input-overview)\
[IGameInputDevice](/fr/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## Historique des versions

| Version | Modifications |
| - | - |
| **v0** | Introduite. |


## Related topics

- [IGameInputDevice](/fr/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [GameInputForceFeedbackMotorInfo](/fr/reference/input/gameinput/structs/gameinputforcefeedbackmotorinfo.md)
- [IGameInputForceFeedbackEffect::GetMotorIndex](/fr/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_getmotorindex.md)
- [IGameInputDevice::SetForceFeedbackMotorGain](/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setforcefeedbackmotorgain.md)
- [CreateForceFeedbackEffect](/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_createforcefeedbackeffect.md)