Skip to main content

XInputGetState

指定されたコントローラーの現在の状態を取得します。

構文

パラメーター

dwUserIndex   _In_
型: DWORD
デバイスに関連付けられているゲーマーのインデックス。0 ~ XUSER_MAX_COUNT - 1 の範囲の値。 pState   _Out_
型: XINPUT_STATE*
コントローラーの現在の状態を受け取る XINPUT_STATE オブジェクトへのポインター。

戻り値

型: DWORD 関数が成功した場合、ERROR_SUCCESS を返します。 コントローラーが接続されていない場合、関数は ERROR_DEVICE_NOT_CONNECTED を返します。 関数が失敗した場合は、WinError.h で定義されているエラー コードを返します。

解説

この関数は、左トリガーと右トリガーを別々に報告します。DirectInput では、2 つのトリガーは同じ軸を共有していました。 XInputGetStateWithToken 関数も同様ですが、呼び出し元は D3DX フレーム パイプライン トークンを指定することで、特定の入力読み取りをグラフィックス フレームに関連付け、後で PIX で分析することができます。 詳細については、XInputOnGameInput ラッパーを参照してください。

要件

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

関連項目

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