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

> Recupera información sobre los motores de retroalimentación de fuerza del dispositivo, como los ejes y los tipos de efecto que admiten.

Recupera información sobre los motores de retroalimentación de fuerza del dispositivo, como los ejes y los tipos de efecto que admiten.

## Sintaxis

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

### Parámetros

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

Número de elementos de *infoArray*. Para recuperar todos los motores de retroalimentación de fuerza, pase el valor devuelto por [GetForceFeedbackMotorCount](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getforcefeedbackmotorcount.md).

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

Puntero a una matriz que recibe una estructura por cada motor de retroalimentación de fuerza. Puede ser `nullptr`, en cuyo caso no se escribe nada y el método devuelve 0.

### Valor devuelto

Tipo: uint32\_t

El número de elementos escritos en *infoArray*. Es el menor de *infoArrayCount* y el número de motores de retroalimentación de fuerza del dispositivo, o 0 si *infoArray* es `nullptr` o el dispositivo no tiene motores de retroalimentación de fuerza.

## Comentarios

Cada elemento es una estructura [GameInputForceFeedbackMotorInfo](https://docs.xbox.com/es/reference/input/gameinput/structs/gameinputforcefeedbackmotorinfo.md) que describe los ejes que acciona el motor correspondiente y los tipos de efecto de retroalimentación de fuerza que admite.

Llame a [GetForceFeedbackMotorCount](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getforcefeedbackmotorcount.md) para obtener el número de motores de retroalimentación de fuerza, asigne una matriz de ese tamaño y, a continuación, llame a `GetForceFeedbackMotorInfo` para rellenarla. Si *infoArrayCount* es menor que el número de motores de retroalimentación de fuerza, solo se escriben los primeros *infoArrayCount* elementos. Los motores de retroalimentación de fuerza de un dispositivo no cambian mientras el dispositivo está conectado, por lo que puede consultarlos una vez y almacenar en caché el resultado.

El elemento *i* de la matriz de información describe el motor que tiene el índice de motor *i*. Use ese índice como parámetro *motorIndex* de [CreateForceFeedbackEffect](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_createforcefeedbackeffect.md), [IsForceFeedbackMotorPoweredOn](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_isforcefeedbackmotorpoweredon.md) y [SetForceFeedbackMotorGain](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setforcefeedbackmotorgain.md).

En el siguiente ejemplo se muestra cómo recuperar los motores de retroalimentación de fuerza de un dispositivo.

```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);
    }
}
```

En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro `forceFeedbackMotorInfo` de la estructura [GameInputDeviceInfo](https://docs.xbox.com/es/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md) devuelta por [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md).

## Requisitos

**Encabezado:** GameInput.h

**Biblioteca:** gameinput.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Información general de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-overview.md)\
[GetForceFeedbackMotorCount](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getforcefeedbackmotorcount.md)\
[GameInputForceFeedbackMotorInfo](https://docs.xbox.com/es/reference/input/gameinput/structs/gameinputforcefeedbackmotorinfo.md)\
[CreateForceFeedbackEffect](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_createforcefeedbackeffect.md)\
[IsForceFeedbackMotorPoweredOn](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_isforcefeedbackmotorpoweredon.md)\
[SetForceFeedbackMotorGain](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setforcefeedbackmotorgain.md)\
[Retroalimentación de fuerza en GameInput](https://docs.xbox.com/es/build/core-features/common/input/advanced/input-forcefeedback.md)\
[IGameInputDevice](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## Historial de versiones

| Versión | Cambios |
| - | - |
| **v4** | Se introdujo. |


## Related topics

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