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

特定のフォース フィードバック モーターの電源がオンになっているかどうかを示します。

## 構文

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

### パラメーター

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

フォース フィードバック モーターのインデックスです。

### 戻り値

型: bool

フォース フィードバック モーターの電源がオンになっていない場合は false を返します。フォース フィードバック モーターの電源がオンになっている場合は true を返します。

## 解説

USB 接続ではモーターを駆動するのに十分な電流を供給できないため、フォース フィードバック モーターには外部電源が必要です。したがって、モーターの電源状態はソフトウェアの制御下にあるものではありません。ただし、その状態を報告することで、アプリケーションがユーザーに通知できるようにすることは可能です。

モーターに電源が供給されていないとき、GameInput のフォース フィードバック メソッドの動作に変化はありません。つまり、デバイスによってエフェクトは再生されません。実質的に、API はプロセスが入力フォーカスを持っていないかのように動作します。電源のないフォース フィードバック モーターにエフェクトを読み込み、その後モーターに電源が供給されると、プロセスが入力フォーカスを獲得した場合と同様にエフェクトの再生が開始されます。入力フォーカス時の動作と同様に、これはプログラミング モデルを簡素化するために行われます。

## 要件

**ヘッダー:** GameInput.h

[GameInput](/reference/input/gameinput/gameinput_members)\
[GameInput の概要](/build/core-features/common/input/overviews/input-overview)\
[IGameInputDevice](/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## バージョン履歴

| バージョン  | 変更点 |
| ------ | --- |
| **v0** | 導入。 |


## Related topics

- [IGameInputDevice::SetForceFeedbackMotorGain](/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setforcefeedbackmotorgain.md)
- [IGameInputForceFeedbackEffect::GetMotorIndex](/ja-jp/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_getmotorindex.md)
- [IGameInputForceFeedbackEffect::GetGain](/ja-jp/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_getgain.md)
- [IGameInputForceFeedbackEffect::SetGain](/ja-jp/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_setgain.md)
- [CreateForceFeedbackEffect](/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_createforcefeedbackeffect.md)