XInputGetCapabilities

接続されているコントローラーの性能や機能を取得します。

DWORD 
XInputGetCapabilities(
  DWORD dwUserIndex,
  DWORD dwFlags,
  XINPUT_CAPABILITIES* pCapabilities
);

パラメータ

  • dwUserIndex
    ユーザーのコントローラーのインデックスです。0 ~ 3 の範囲の値を指定できます。この値を決定する方法と、値がコントローラー上のインジケーターにマップされる方法については、「複数のコントローラー」を参照してください。

  • dwFlags
    コントローラー タイプを識別する入力フラグです。この値が 0 の場合は、システムに接続されているすべてのコントローラーの性能が返されます。現在は 1 つの値のみがサポートされています。

    説明
    XINPUT_FLAG_GAMEPADクエリの対象を Xbox 360 コントローラー タイプのデバイスに限定します。

    dwflags が上記の値または 0 のいずれでもない場合は無効です。デバッグ時にエラー ブレークが発生します。

  • pCapabilities
    コントローラーの性能を受け取る XINPUT_CAPABILITIES 構造体へのポインターです。

戻り値

成功すると、ERROR_SUCCESS を返します。

コントローラーが接続されていない場合は、ERROR_DEVICE_NOT_CONNECTED が返されます。

この関数が失敗した場合は、Winerror.h に定義されているエラー コードが返されます。この関数は、呼び出しスレッドの最後のエラー コードを設定する SetLastError を使用しません。

要件

ヘッダー: XInput.h 宣言

ライブラリ: Xinput.lib 内容

関連項目

XInput 関数 | XInputGetStateXInputSetState