XInputEnable 函数 (xinput.h)

设置 XInput 的报告状态。

语法

void XInputEnable(
  [in] BOOL enable
);

参数

[in] enable

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

返回值

没有

言论

当应用程序获得或失去焦点(如通过 WM_ACTIVATEAPP)时,将调用此函数。 使用此函数时,不必更改应用程序中的 XInput 查询循环,因为如果禁用 XInput,将始终报告中性数据。

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

  • 传递 FALSE 将停止当前播放的任何振动效果。 在此状态下,将注册对 XInputSetState 的调用,但不会传递给设备。
  • 传递 TRUE 会将最后一个振动请求(即使为 0)发送到设备 XInputSetState

Windows 10 或更高版本:弃用,因为基于应用程序窗口焦点的系统自动启用/禁用游戏控制器输入。

平台要求

Windows 8 (XInput 1.4)、 DirectX SDK (XInput 1.3)

要求

要求 价值
目标平台 窗户
标头 xinput.h
Xinput.lib
DLL Xinput1_4.dll

另请参阅

XINPUT_GAMEPAD

XINPUT_STATE

XInput 函数

XInputGetState

XInputSetState