XInputGetCapabilities 関数 (xinput.h)
接続されたコントローラーの機能と機能を取得します。
構文
DWORD XInputGetCapabilities(
[in] DWORD dwUserIndex,
[in] DWORD dwFlags,
[out] XINPUT_CAPABILITIES *pCapabilities
);
パラメーター
[in] dwUserIndex
ユーザーのコントローラーのインデックス。 0 ~ 3 の範囲の値を指定できます。 この値の決定方法と、値がコントローラー上のインジケーターにマップされる方法については、「複数の コントローラー」を参照してください。
[in] dwFlags
コントローラーの種類を識別する入力フラグ。 この値が 0 の場合は、システムに接続されているすべてのコントローラーの機能が返されます。 現在、サポートされている値は 1 つだけです。
| 値 | 説明 |
|---|---|
| XINPUT_FLAG_GAMEPAD | コントローラーの種類のデバイスにクエリを制限します。 |
上記または 0 以外の 値の dwlags は無効であり、デバッグ時にエラーが発生します。
[out] pCapabilities
コントローラー機能を受け取る XINPUT_CAPABILITIES 構造体へのポインター。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS。
コントローラーが接続されていない場合、戻り値は ERROR_DEVICE_NOT_CONNECTED。
関数が失敗した場合、戻り値は WinError.h で定義されたエラー コードです。 関数は、呼び出し元スレッドの最後のエラー コードを設定するために SetLastError を使用しません。
注釈
メモ 従来の XINPUT 9.1.0 バージョン (Windows Vista 以降に含まれる) は、接続されているデバイスに関係なく、常に固定の機能セットを返しました。
プラットフォームの要件
Windows 8 (XInput 1.4)、DirectX SDK (XInput 1.3)、Windows Vista (XInput 9.1.0)要件
| 対象プラットフォーム | Windows |
| ヘッダー | xinput.h |
| Library | Xinput.lib;Xinput9_1_0.lib |
| [DLL] | Xinput1_4.dll;Xinput9_1_0.dll |