XInputGetState
指定されたコントローラーの現在の状態を取得します。
構文
DWORD XInputGetState(
DWORD dwUserIndex,
XINPUT_STATE * pState
)
パラメーター
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 本体