Skip to main content

XInputGetStateWithToken

检索指定控制器的当前状态,并将其与 D3DX 帧管线令牌相关联。

语法

参数

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
最后修改于 2026年8月24日