XInputEnable

设置 XInput 的报告状态。

语法

void XInputEnable(  
         BOOL enable  
)  

参数

enable _In_
类型：BOOL

如果启用为 FALSE，则 XInput 为响应 XInputGetState 将仅发送中性数据：即，所有按钮向上、轴居中，并且在 0 触发。 XInputSetState 调用将注册，但不会发送到设备。 发送除 FALSE 以外的任何值都将读取和写入功能还原回正常。

返回值

类型：void

无。

备注

此函数已弃用，不应写入任何新代码。 XInputEnable 为许多 XInput 包装器调用增加了开销。 您可以使用 #define XINPUT_ON_GAMEINPUT_NO_XINPUTENABLE清除 XInputEnable 以及由此产生的开销。 有关详细信息，请参阅从 XInput 移植到 GameInput。

此函数旨在当应用程序获得或失去焦点时被调用。 在使用此函数时，您将无需在应用程序中更改 XInput 查询循环，因为在禁用 XInput 的情况下，将始终报告中性数据。

在支持振动效果的控制器中：

• 传递 FALSE 将停止此刻正在播放的任何振动效果。 在此状态下，对 XInputSetState 的调用将注册，但不会传递到设备。
• 传递 TRUE 会将发送至 XInputSetState 的上一个振动请求（即使是 0）并传递到设备。

要求

头文件：XInputOnGameInput.h

库：xgameruntime.lib

支持的平台：Xbox One 系列主机和 Xbox Series 主机

另请参阅

从 XInput 移植到 GameInput
XInputOnGameInput
XInputGetState
XInputSetState