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 類似,但會將特定輸入讀數與圖形畫面產生關聯,以便稍後進行分析。
自 May Preview 版本起,XInputGetStateWithToken 的行為與 XInputGetState 相同,因為基礎 GameInput 程式碼尚未完全實作。
透過提供畫面管線權杖,您之後可以在 PIX 軟體中將輸入 API 呼叫與特定圖形畫面建立關聯。

需求

標頭: XInputOnGameInput.h 程式庫: xgameruntime.lib 支援的平台: XBOX One 系列主機和 XBOX Series 主機

另請參閱

從 XInput 移植到 GameInput
XInputOnGameInput
Last modified on October 6, 2026