XInputGetState
指定されたコントローラーの現在の状態を取得します。
DWORD
XInputGetState(
DWORD dwUserIndex,
XINPUT_STATE* pState
);
パラメータ
- dwUserIndex
ユーザーのコントローラーのインデックスです。0 ～ 3 の値を指定できます。この値を決定する方法と、値がコントローラー上のインジケーターにマップされる方法については、「複数のコントローラー」を参照してください。 - pState
コントローラーの現在の状態を受け取る XINPUT_STATE 構造体へのポインターです。
戻り値
成功すると、ERROR_SUCCESS を返します。
コントローラーが接続されていない場合は、ERROR_DEVICE_NOT_CONNECTED が返されます。
この関数が失敗した場合は、Winerror.h に定義されているエラー コードが返されます。この関数は、呼び出しスレッドの最後のエラー コードを設定する SetLastError を使用しません。
解説
XInputGetState を使用してコントローラー データを取得すると、左と右のトリガーが別々にレポートされます。従来の処理上の理由により、DirectInput® がコントローラー データを取得するときに、2 つのトリガーは同じ軸を共有します。従来の動作は、コントローラーの状態に対して DirectInput を使用する現在のゲーム デバイス コントロール パネルで確認できます。
要件
ヘッダー: XInput.h 宣言
ライブラリ: Xinput.lib 内容