XINPUT_CAPABILITIES構造体 (xinput.h)

[アーティクル]
03/05/2024

接続されたコントローラーの機能について説明します。 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 ドライバーは、有線およびワイヤレスデバイスの完全なサポートと、より完全で正確な機能フラグを提供します。