> ## 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](/zh-TW/reference/input/xinputongameinput/functions/xinputgetstate)：也就是所有按鈕放開、軸置中，且扳機為 0。[XInputSetState](/zh-TW/reference/input/xinputongameinput/functions/xinputsetstate) 呼叫會被登錄，但不會傳送至裝置。傳送 **FALSE** 以外的任何值，都會將讀取和寫入功能還原為正常狀態。

### 傳回值

類型：void

無。

## 備註

此函式已淘汰，不應寫入任何新程式碼中。XInputEnable 會增加許多 XInput 包裝函式呼叫的額外負荷。您可以 `#define XINPUT_ON_GAMEINPUT_NO_XINPUTENABLE` 以移除 XInputEnable 及其產生的額外負荷。如需詳細資訊，請參閱[從 XInput 移植到 GameInput](/zh-TW/build/core-features/common/input/porting/input-porting-xinput#optimizingSection)。

此函式應在應用程式取得或失去焦點時呼叫。使用此函式時，您不必變更應用程式中的 XInput 查詢迴圈，因為停用 XInput 時一律會回報中性資料。

在支援震動效果的控制器中：

* 傳遞 **FALSE** 會停止目前正在播放的任何震動效果。在此狀態下，對 [XInputSetState](/zh-TW/reference/input/xinputongameinput/functions/xinputsetstate) 的呼叫會被登錄，但不會傳遞至裝置。
* 傳遞 **TRUE** 會將傳送至 [XInputSetState](/zh-TW/reference/input/xinputongameinput/functions/xinputsetstate) 的最後一個震動要求 (即使為 0) 傳遞至裝置。

## 需求

**標頭：** XInputOnGameInput.h

**程式庫：** xgameruntime.lib

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[將 XInput 移植到 GameInput](/zh-TW/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/zh-TW/reference/input/xinputongameinput/xinputongameinput_members)\
[XInputGetState](/zh-TW/reference/input/xinputongameinput/functions/xinputgetstate)\
[XInputSetState](/zh-TW/reference/input/xinputongameinput/functions/xinputsetstate)


## Related topics

- [XInputOnGameInput](/zh-TW/reference/input/xinputongameinput/xinputongameinput_members.md)
- [從 XInput 移植到 GameInput](/zh-TW/build/core-features/common/input/porting/input-porting-xinput.md)
- [IGameInput::EnableOemDeviceSupport](/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_enableoemdevicesupport.md)
- [XGameStreamingIsTouchInputEnabled](/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingistouchinputenabled.md)
- [GameInputFocusPolicy](/zh-TW/reference/input/gameinput/enums/gameinputfocuspolicy.md)