XINPUT_CAPABILITIES

接続されたコントローラーの機能を表します。

構文

typedef struct XINPUT_CAPABILITIES {  
    BYTE Type;  
    BYTE SubType;  
    WORD Flags;  
    XINPUT_GAMEPAD Gamepad;  
    XINPUT_VIBRATION Vibration;  
} XINPUT_CAPABILITIES  

メンバー

Type
型: BYTE コントローラーの種類。XINPUT_DEVTYPE_GAMEPAD 型で、下表に示すいずれかの値を取る必要があります。 SubType
型: BYTE ゲームコントローラーのサブタイプ。使用可能なサブタイプ:

サブタイプ	意味
XINPUT_DEVSUBTYPE_UNKNOWN	不明。コントローラーの種類は不明です。
XINPUT_DEVSUBTYPE_GAMEPAD	ゲームパッドコントローラー。左右のスティック、左右のトリガー、方向パッド、および A、B、X、Y、START、BACK、LB、RB、LSB、RSB のすべての標準ボタンが含まれます。
XINPUT_DEVSUBTYPE_WHEEL	レーシングホイールコントローラー。左スティック X はホイールの回転を報告し、右トリガーはアクセルペダル、左トリガーはブレーキペダルです。方向パッドとほとんどの標準ボタン (A、B、X、Y、START、BACK、LB、RB) が含まれます。LSB と RSB は任意です。
XINPUT_DEVSUBTYPE_ARCADE_STICK	アーケードスティックコントローラー。DPAD (上、下、左、右) として報告されるデジタルスティックと、ほとんどの標準ボタン (A、B、X、Y、START、BACK) が含まれます。左右のトリガーはデジタルボタンとして実装されており、0 または 0xFF のいずれかを報告します。LB、LSB、RB、RSB は任意です。
XINPUT_DEVSUBTYPE_FLIGHT_STICK	フライトスティックコントローラー。左スティックとして報告されるピッチアンドロールスティック、右スティックとして報告される POV ハット、左トリガーとして報告されるラダー (ハンドルツイストまたはロッカー)、右トリガーとしてのスロットルコントロールが含まれます。プライマリウェポン (A)、セカンダリウェポン (B)、およびその他の標準ボタン (X、Y、START、BACK) がサポートされます。LB、LSB、RB、RSB は任意です。
XINPUT_DEVSUBTYPE_DANCE_PAD	ダンスパッドコントローラー。パッド上の方向パッドと標準ボタン (A、B、X、Y)、および BACK と START が含まれます。
XINPUT_DEVSUBTYPE_GUITAR XINPUT_DEVSUBTYPE_GUITAR_ALTERNATE XINPUT_DEVSUBTYPE_GUITAR_BASS	ギターコントローラー。ストラムバーは DPAD (上下) にマップされ、フレットは A (緑)、B (赤)、Y (黄)、X (青)、LB (オレンジ) に割り当てられます。右スティック Y は垂直方向センサーに関連付けられ、右スティック X はワミーバーです。BACK、START、および DPAD (左、右) のサポートが含まれます。左トリガー (ピックアップセレクター)、右トリガー、RB、LSB (フレットモディファイア)、RSB は任意です。Guitar Bass は Guitar と同じですが、セットアップを簡略化するために別のサブタイプが用意されています。Guitar Alt は垂直方向センサーの動作範囲がより大きくなります。
XINPUT_DEVSUBTYPE_DRUM_KIT	ドラムコントローラー。ドラムパッドはボタンに割り当てられます。A は緑 (フロアタム)、B は赤 (スネアドラム)、X は青 (ロータム)、Y は黄 (ハイタム)、LB はペダル (バスドラム) です。方向パッド、BACK、START が含まれます。RB、LSB、RSB は任意です。
XINPUT_DEVSUBTYPE_ARCADE_PAD	アーケードパッドコントローラー。方向パッドおよびほとんどの標準ボタン (A、B、X、Y、START、BACK、LB、RB) が含まれます。左右のトリガーはデジタルボタンとして実装されており、0 または 0xFF のいずれかを報告します。左スティック、右スティック、LSB、RSB は任意です。

Flags
型: WORD コントローラーの機能。

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

Gamepad
型: XINPUT_GAMEPAD 利用可能なコントローラー機能とコントロールの分解能を表す XINPUT_GAMEPAD 構造体。 Vibration
型: XINPUT_VIBRATION 利用可能なバイブレーション機能と分解能を表す XINPUT_VIBRATION 構造体。

解説

XInputGetCapabilities は、指定したコントローラーの特性と利用可能な機能を示す XINPUT_CAPABILITIES を返します。 XInputGetCapabilities は、デバイスがサポートする入力を示すよう構造体メンバーを設定します。デジタルボタンなどのバイナリ状態のコントロールでは、該当するビットにデバイスがそのコントロールをサポートしているかどうかが反映されます。サムスティックのような比例コントロールでは、値がそのコントロールの分解能を示します。下位のビットのいくつかが設定されない場合があり、その場合はコントロールがそのレベルの分解能を提供しないことを示します。 SubType メンバーは、存在するコントローラーの具体的なサブタイプを示します。ゲームはコントローラーのサブタイプを検出し、そのゲームのジャンルによく合うサブタイプに従ってコントローラー入力または出力の処理を調整することがあります。たとえば、カーレーシングゲームでは、運転する車をより細かく制御するためにホイールコントローラーの有無を確認することがあります。ただし、タイトルはサブタイプに応じてデバイスを無効化したり無視したりしてはいけません。ゲームが認識しないサブタイプ、またはゲームが特にチューニングされていないサブタイプは、標準ゲームパッド XINPUT_DEVSUBTYPE_GAMEPAD として扱う必要があります。古い XUSB Windows ドライバーは、特にワイヤレスデバイスについて不完全な機能情報を報告します。最新の XUSB Windows ドライバーは有線およびワイヤレスデバイスを完全にサポートし、より完全で正確な機能フラグを提供します。

要件

ヘッダー: XInputOnGameInput.h 対応プラットフォーム: XBOX One ファミリー本体および XBOX Series 本体

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XINPUT_CAPABILITIES

XINPUT_CAPABILITIES

構文

メンバー

解説

要件

関連項目

​XINPUT_CAPABILITIES

​構文

​メンバー

​解説

​要件

​関連項目

XINPUT_CAPABILITIES

構文

メンバー

解説

要件

関連項目