Share via

XINPUT_CAPABILITIES構造体 (xinput.h)

  • [アーティクル]

接続されたコントローラーの機能について説明します。 XInputGetCapabilities 関数は、XINPUT_CAPABILITIESを返します。

構文

typedef struct _XINPUT_CAPABILITIES {
  BYTE             Type;
  BYTE             SubType;
  WORD             Flags;
  XINPUT_GAMEPAD   Gamepad;
  XINPUT_VIBRATION Vibration;
} XINPUT_CAPABILITIES, *PXINPUT_CAPABILITIES;

メンバー

Type

コントローラーの種類。 次のいずれかの値を指定する必要があります。

値 説明
XINPUT_DEVTYPE_GAMEPAD デバイスはゲーム コントローラーです。 

SubType

ゲーム コントローラーのサブタイプ。 許可されるサブタイプの一覧については、「 XINPUT サブタイプとコントローラー サブタイプ」を参照してください。

メモ このサブタイプ値の使用に関する制限については、「解説」を参照してください。 今後、さらにサブタイプが追加される可能性があります。
 

Flags

コントローラーの機能。

値 説明
XINPUT_CAPS_VOICE_SUPPORTED デバイスには統合された音声デバイスがあります。
XINPUT_CAPS_FFB_SUPPORTED デバイスでは、強制フィードバック機能がサポートされています。 これらの強制フィードバック機能は、現在、Windows 上の XINPUT ではサポートされていないことに注意してください。
XINPUT_CAPS_WIRELESS デバイスはワイヤレスです。
XINPUT_CAPS_PMD_SUPPORTED デバイスはプラグイン モジュールをサポートしています。 テキスト入力デバイス (TID) などのプラグイン モジュールは、Windows 上の XINPUT では現在サポートされていないことに注意してください。
XINPUT_CAPS_NO_NAVIGATION デバイスにメニュー ナビゲーション ボタン (START、BACK、DPAD) がありません。

Gamepad

XINPUT_GAMEPAD 使用可能なコントローラーの機能と制御の解像度を説明する構造です。

Vibration

XINPUT_VIBRATION 使用可能な振動機能と解像度を記述する構造です。

注釈

XInputGetCapabilities は 、指定 したコントローラーの特性と使用可能な機能を示すXINPUT_CAPABILITIESを返します。

XInputGetCapabilities は、デバイスがサポートする入力を示す構造体メンバーを設定します。 デジタル ボタンなどのバイナリ状態コントロールの場合、対応するビットは、コントロールがデバイスでサポートされているかどうかを反映します。 サムスティックなどの比例コントロールの場合、値はそのコントロールの解像度を示します。 最下位ビットの一部の数を設定することはできません。これは、コントロールがそのレベルに対する解像度を提供しないことを示します。

SubType メンバーは、存在するコントローラーの特定のサブタイプを示します。 ゲームでは、コントローラーのサブタイプを検出し、ゲームのジャンルに適したサブタイプに基づいてコントローラーの入力または出力の処理を調整できます。 たとえば、車のレース ゲームは、駆動中の車の細かい制御を提供するホイール コントローラーの存在のためにチェック可能性があります。 ただし、タイトルは、そのサブタイプに基づいてデバイスを無効にしたり無視したりすることはできません。 ゲームによって認識されないサブタイプ、またはゲームが特に調整されていないサブタイプは、標準コントローラー (XINPUT_DEVSUBTYPE_GAMEPAD) として扱う必要があります。

以前の XUSB Windows ドライバーでは、特にワイヤレス デバイスの不完全な機能情報が報告されます。 最新の XUSB Windows ドライバーは、有線およびワイヤレス デバイスの完全なサポートと、より完全で正確な機能フラグを提供します。

要件

要件 値
Header xinput.h

こちらもご覧ください

XINPUT_GAMEPAD

XINPUT_VIBRATION

XInput 構造体

XInputGetCapabilities