XInputGetState
检索指定控制器的当前状态。
语法
DWORD XInputGetState(
DWORD dwUserIndex,
XINPUT_STATE * pState
)
参数
dwUserIndex _In_
类型:DWORD
与设备相关联的玩家的索引;介于 0 到 XUSER_MAX_COUNT - 1
之间的值。
pState _Out_
类型:XINPUT_STATE*
指向接收控制器的当前状态的 XINPUT_STATE 对象的指针。
返回值
类型:DWORD
如果此函数成功,则返回 ERROR_SUCCESS
。
如果控制器未连接,则该函数将返回 ERROR_DEVICE_NOT_CONNECTED
。
如果该函数失败,则将返回在 WinError.h 中定义的错误代码。
备注
此函数分别报告左侧和右侧扳机键。 在 DirectInput,两扳机键公用一个轴。
XInputGetStateWithToken 功能类似 ,但允许调用方提供 D3DX 帧管道令牌,以将特定输入读取与图形帧相关联,以便以后在 PIX 中进行分析。
有关详细信息,请参阅 XInputOnGameInput 包装器。
要求
头文件:XInputOnGameInput.h
库:xgameruntime.lib
支持的平台:Xbox One 系列主机和 Xbox Series 主机