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 |