XInputGetState 函数 (xinput.h)

检索指定控制器的当前状态。

语法

DWORD XInputGetState(
  [in]  DWORD        dwUserIndex,
  [out] XINPUT_STATE *pState
);

[in] dwUserIndex

用户控制器的索引。可以是 0 到 3 的值。有关如何确定此值以及如何将值映射到控制器上的指示器的信息，请参阅多个控制器。

[out] pState

指向接收控制器当前状态的XINPUT_STATE 结构的指针。

如果函数成功，则返回值 ERROR_SUCCESS。

如果未连接控制器，则返回值 ERROR_DEVICE_NOT_CONNECTED。

如果函数失败，则返回值为 Winerror.h 中定义的错误代码。函数不使用 SetLastError 设置调用线程的最后错误代码。

使用 XInputGetState 检索控制器数据时，将分别报告左触发器和右触发器。出于传统原因，当 DirectInput 检索控制器数据时，两个触发器共享同一轴。旧行为在当前游戏设备控制面板中很明显，它使用 DirectInput 进行控制器状态。

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

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