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

# XInputEnable

> XInputEnable

# XInputEnable

XInput のレポート状態を設定します。

## 構文

```cpp theme={null}
void XInputEnable(  
         BOOL enable  
)  
```

### パラメーター

*enable*   \_In\_\
型: BOOL

enable が **FALSE** の場合、XInput は [XInputGetState](/reference/input/xinputongameinput/functions/xinputgetstate) への応答として中立データのみを送信します。つまり、すべてのボタンは押されていない、軸は中央、トリガーは 0 の状態です。[XInputSetState](/reference/input/xinputongameinput/functions/xinputsetstate) の呼び出しは登録されますが、デバイスには送信されません。**FALSE** 以外の値を送信すると、読み取りと書き込みの機能が通常の状態に戻ります。

### 戻り値

型: void

なし。

## 解説

この関数は非推奨であり、新しいコードには記述しないでください。XInputEnable は多くの XInput ラッパー呼び出しにオーバーヘッドを追加します。`#define XINPUT_ON_GAMEINPUT_NO_XINPUTENABLE` を定義することで、XInputEnable とそれに伴うオーバーヘッドを削除できます。詳細については、[XInput から GameInput への移植](/build/core-features/common/input/porting/input-porting-xinput#optimizingSection)を参照してください。

この関数は、アプリケーションがフォーカスを取得または喪失したときに呼び出すことを意図しています。この関数を使用する場合、XInput が無効な場合には常に中立データが報告されるため、アプリケーション内の XInput クエリ ループを変更する必要はありません。

バイブレーション効果をサポートするコントローラーでの動作:

* **FALSE** を渡すと、現在再生中のバイブレーション効果が停止します。この状態では、[XInputSetState](/reference/input/xinputongameinput/functions/xinputsetstate) の呼び出しは登録されますが、デバイスには渡されません。
* **TRUE** を渡すと、[XInputSetState](/reference/input/xinputongameinput/functions/xinputsetstate) およびデバイスに送信された最後のバイブレーション要求 (それが 0 であっても) が渡されます。

## 要件

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

**ライブラリ:** xgameruntime.lib

**対応プラットフォーム:** XBOX One ファミリー本体および XBOX Series 本体

## 関連項目

[XInput から GameInput への移植](/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/reference/input/xinputongameinput/xinputongameinput_members)\
[XInputGetState](/reference/input/xinputongameinput/functions/xinputgetstate)\
[XInputSetState](/reference/input/xinputongameinput/functions/xinputsetstate)


## Related topics

- [XInputOnGameInput](/ja-jp/reference/input/xinputongameinput/xinputongameinput_members.md)
- [XInput から GameInput への移植](/ja-jp/build/core-features/common/input/porting/input-porting-xinput.md)
- [IGameInput::EnableOemDeviceSupport](/ja-jp/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_enableoemdevicesupport.md)
- [XGameStreamingIsTouchInputEnabled](/ja-jp/reference/system/xgamestreaming/functions/xgamestreamingistouchinputenabled.md)
- [Input](/ja-jp/build/core-features/common/input/gc-input-toc.md)