> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IGameInputDevice::GetForceFeedbackMotorInfo

> Récupère des informations sur les moteurs de retour de force du périphérique, comme les axes et les types d'effets qu'ils prennent en charge.

Récupère des informations sur les moteurs de retour de force du périphérique, comme les axes et les types d'effets qu'ils prennent en charge.

## Syntaxe

```cpp theme={null}
uint32_t GetForceFeedbackMotorInfo(
    uint32_t infoArrayCount,
    GameInputForceFeedbackMotorInfo* infoArray
);
```

### Paramètres

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

Nombre d'éléments de *infoArray*. Pour récupérer tous les moteurs de retour de force, transmettez la valeur retournée par [GetForceFeedbackMotorCount](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getforcefeedbackmotorcount.md).

*infoArray*   \_Out\_writes\_to\_opt\_(infoArrayCount, return)\
Type : [GameInputForceFeedbackMotorInfo](https://docs.xbox.com/fr/reference/input/gameinput/structs/gameinputforcefeedbackmotorinfo.md)\*

Pointeur vers un tableau qui reçoit une structure par moteur de retour de force. Peut être `nullptr`, auquel cas rien n'est écrit et la méthode retourne 0.

### Valeur de retour

Type : uint32\_t

Nombre d'éléments écrits dans *infoArray*. Il s'agit de la plus petite valeur entre *infoArrayCount* et le nombre de moteurs de retour de force du périphérique, ou de 0 si *infoArray* est `nullptr` ou si le périphérique n'a aucun moteur de retour de force.

## Remarques

Chaque élément est une structure [GameInputForceFeedbackMotorInfo](https://docs.xbox.com/fr/reference/input/gameinput/structs/gameinputforcefeedbackmotorinfo.md) qui décrit les axes actionnés par le moteur correspondant et les types d'effets de retour de force qu'il prend en charge.

Appelez [GetForceFeedbackMotorCount](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getforcefeedbackmotorcount.md) pour obtenir le nombre de moteurs de retour de force, allouez un tableau de cette taille, puis appelez `GetForceFeedbackMotorInfo` pour le remplir. Si *infoArrayCount* est inférieur au nombre de moteurs de retour de force, seuls les *infoArrayCount* premiers éléments sont écrits. Les moteurs de retour de force d'un périphérique ne changent pas tant que le périphérique est connecté ; vous pouvez donc les interroger une seule fois et mettre le résultat en cache.

L'élément *i* du tableau d'informations décrit le moteur dont l'index de moteur est *i*. Utilisez cet index comme paramètre *motorIndex* de [CreateForceFeedbackEffect](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_createforcefeedbackeffect.md), [IsForceFeedbackMotorPoweredOn](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_isforcefeedbackmotorpoweredon.md) et [SetForceFeedbackMotorGain](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setforcefeedbackmotorgain.md).

L'exemple suivant montre comment récupérer les moteurs de retour de force d'un périphérique.

```cpp theme={null}
uint32_t motorCount = device->GetForceFeedbackMotorCount();
std::vector<GameInputForceFeedbackMotorInfo> motorInfo(motorCount);
motorInfo.resize(device->GetForceFeedbackMotorInfo(motorCount, motorInfo.data()));

for (uint32_t motorIndex = 0; motorIndex < motorInfo.size(); ++motorIndex)
{
    if (motorInfo[motorIndex].isConstantEffectSupported)
    {
        GameInputForceFeedbackParams params = {};
        params.kind = GameInputForceFeedbackConstant;
        // Fill in the remaining effect parameters...

        Microsoft::WRL::ComPtr<IGameInputForceFeedbackEffect> effect;
        device->CreateForceFeedbackEffect(motorIndex, &params, &effect);
    }
}
```

Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles via le membre `forceFeedbackMotorInfo` de la structure [GameInputDeviceInfo](https://docs.xbox.com/fr/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md) retournée par [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/fr/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md).

## Configuration requise

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

**Bibliothèque :** gameinput.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[Vue d'ensemble de GameInput](https://docs.xbox.com/fr/build/core-features/common/input/overviews/input-overview.md)\
[GetForceFeedbackMotorCount](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getforcefeedbackmotorcount.md)\
[GameInputForceFeedbackMotorInfo](https://docs.xbox.com/fr/reference/input/gameinput/structs/gameinputforcefeedbackmotorinfo.md)\
[CreateForceFeedbackEffect](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_createforcefeedbackeffect.md)\
[IsForceFeedbackMotorPoweredOn](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_isforcefeedbackmotorpoweredon.md)\
[SetForceFeedbackMotorGain](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setforcefeedbackmotorgain.md)\
[Retour de force dans GameInput](https://docs.xbox.com/fr/build/core-features/common/input/advanced/input-forcefeedback.md)\
[IGameInputDevice](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## Historique des versions

| Version | Modifications |
| - | - |
| **v4** | Introduite. |


## Related topics

- [GameInputForceFeedbackMotorInfo](https://docs.xbox.com/fr/reference/input/gameinput/structs/gameinputforcefeedbackmotorinfo.md)
- [GameInputFeedbackAxes](https://docs.xbox.com/fr/reference/input/gameinput/enums/gameinputfeedbackaxes.md)
- [Retour de force sur GameInput](https://docs.xbox.com/fr/build/core-features/common/input/advanced/input-forcefeedback.md)
- [IGameInputDevice::GetForceFeedbackMotorCount](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getforcefeedbackmotorcount.md)
- [IGameInputForceFeedbackEffect::GetDevice](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_getdevice.md)