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

另请参阅

从 XInput 移植到 GameInput
XInputOnGameInput