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 主机

另请参阅

从 XInput 移植到 GameInput
XInputOnGameInput