> ## 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 se um motor de force feedback específico está ligado.

## Sintaxe

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

### Parâmetros

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

Índice do motor de force feedback.

### Valor retornado

Tipo: bool

Retorna false se o motor de force feedback não estiver ligado. Retorna true se o motor de force feedback estiver ligado.

## Comentários

Os motores de force feedback exigem uma fonte de alimentação externa porque uma conexão USB não consegue fornecer corrente suficiente para acionar o motor. Portanto, o estado de energia de um motor não é algo que esteja sob o controle do software. No entanto, ele pode ser relatado para que um aplicativo possa notificar o usuário.

Não há alteração no comportamento de nenhum método de force feedback do GameInput quando um motor está sem energia; assim, nenhum efeito será reproduzido pelo dispositivo. Essencialmente, as APIs funcionam como se o processo não tivesse o foco de entrada. Se os efeitos forem carregados em um motor de force feedback sem energia e, posteriormente, o motor receber energia, os efeitos começarão a ser reproduzidos como se o processo tivesse obtido o foco de entrada. Assim como no comportamento do foco de entrada, isso é feito para simplificar o modelo de programação.

## Requisitos

**Cabeçalho:** GameInput.h

[GameInput](/pt-BR/reference/input/gameinput/gameinput_members)\
[Visão geral do GameInput](/pt-BR/build/core-features/common/input/overviews/input-overview)\
[IGameInputDevice](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v0** | Introduzido. |


## Related topics

- [IGameInputDevice](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [GameInputForceFeedbackMotorInfo](/pt-BR/reference/input/gameinput/structs/gameinputforcefeedbackmotorinfo.md)
- [Force feedback no GameInput](/pt-BR/build/core-features/common/input/advanced/input-forcefeedback.md)
- [IGameInputForceFeedbackEffect::GetMotorIndex](/pt-BR/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_getmotorindex.md)
- [IGameInputDevice::SetForceFeedbackMotorGain](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setforcefeedbackmotorgain.md)