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 月のプレビュー リリース時点では、基になる GameInput コードが完全には実装されていないため、XInputGetStateWithToken の動作は XInputGetState と同一です。
フレーム パイプライン トークンを指定することで、後で PIX ソフトウェアの特定のグラフィックス フレームと入力 API 呼び出しを関連付けることができます。

要件

ヘッダー: XInputOnGameInput.h ライブラリ: xgameruntime.lib 対応プラットフォーム: XBOX One ファミリー本体および XBOX Series 本体

関連項目

XInput から GameInput への移植
XInputOnGameInput
最終更新日 2026年8月24日