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

こちらもご覧ください

XInput 関数

XInputGetState

XInputSetState