XInputEnable 函数 (xinput.h)

  • 项目

设置 XInput 的报告状态。

语法

void XInputEnable(
  [in] BOOL enable
);

参数

[in] enable

如果 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)

要求

要求 值
目标平台 Windows
标头 xinput.h
Library Xinput.lib
DLL Xinput1_4.dll

另请参阅

XINPUT_GAMEPAD

XINPUT_STATE

XInput 函数

XInputGetState

XInputSetState