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

Indica si un motor de retroalimentación de fuerza específico está encendido.

## Sintaxis

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

### Parámetros

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

Índice del motor de retroalimentación de fuerza.

### Valor devuelto

Tipo: bool

Devuelve false si el motor de retroalimentación de fuerza no está encendido. Devuelve true si el motor de retroalimentación de fuerza está encendido.

## Comentarios

Los motores de retroalimentación de fuerza requieren una fuente de alimentación externa porque una conexión USB no puede proporcionar suficiente corriente para accionar el motor. Por lo tanto, el estado de alimentación de un motor no es algo que esté bajo el control del software. Sin embargo, se puede notificar para que una aplicación pueda avisar al usuario.

No hay ningún cambio en el comportamiento de los métodos de retroalimentación de fuerza de GameInput cuando un motor no tiene alimentación; por lo tanto, el dispositivo no reproducirá ningún efecto. Básicamente, las API funcionan como si el proceso no tuviera el foco de entrada. Si los efectos se cargan en un motor de retroalimentación de fuerza sin alimentación y posteriormente se suministra alimentación al motor, los efectos comenzarán a reproducirse como si el proceso hubiera obtenido el foco de entrada. Al igual que con el comportamiento del foco de entrada, esto se hace para simplificar el modelo de programación.

## Requisitos

**Encabezado:** GameInput.h

[GameInput](/reference/input/gameinput/gameinput_members)\
[Información general de GameInput](/build/core-features/common/input/overviews/input-overview)\
[IGameInputDevice](/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## Historial de versiones

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


## Related topics

- [Force feedback en GameInput](/es/build/core-features/common/input/advanced/input-forcefeedback.md)
- [IGameInputForceFeedbackEffect::GetMotorIndex](/es/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_getmotorindex.md)
- [IGameInputDevice::SetForceFeedbackMotorGain](/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setforcefeedbackmotorgain.md)
- [CreateForceFeedbackEffect](/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_createforcefeedbackeffect.md)
- [IGameInputForceFeedbackEffect::SetGain](/es/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_setgain.md)