XInputGetStateWithToken
检索指定控制器电流状态并将其与D3DX 帧管道令牌关联。
语法
DWORD XInputGetStateWithToken(
DWORD dwUserIndex,
UINT64 framePipelineToken,
XINPUT_STATE * pState
)
参数
dwUserIndex _In_
类型:DWORD
与设备相关联的玩家的索引;介于 0 到 XUSER_MAX_COUNT - 1
之间的值。
framePipelineToken _In_
类型:UINT64
D3DX 帧管道令牌。
pState _Out_
类型:XINPUT_STATE*
指向接收控制器的当前状态的 XINPUT_STATE 对象的指针。
返回值
类型:DWORD
如果此函数成功,则返回 ERROR_SUCCESS
。
如果控制器未连接,则该函数将返回 ERROR_DEVICE_NOT_CONNECTED
。
如果该函数失败,则将返回在 WinError.h 中定义的错误代码。
备注
此函数类似XInputGetState,但关联了图形框架指定输入读取以用于后续分析。
注意
截至 5 月预览版,XInputGetStateWithToken
的行为与 XInputGetState
的相同,因为底层的 GameInput 代码没有完全实现。
通过提供帧管道令牌,你可以在以后使用 PIX 软件中的特定图形帧关联输入 API 调用。
要求
头文件:XInputOnGameInput.h
库:xgameruntime.lib
支持的平台:Xbox One 系列主机和 Xbox Series 主机