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	街机摇杆控制器。包括一个作为方向键（上、下、左、右）报告的数字摇杆和大多数标准按钮：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	吉他控制器。扫弦条映射到方向键（上和下），品格分配为 A（绿）、B（红）、Y（黄）、X（蓝）和 LB（橙）。右摇杆的 Y 轴与垂直方向传感器关联，右摇杆的 X 轴为摇把。支持 BACK、START 和方向键（左、右）。左扳机（拾音器选择器）、右扳机、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	设备支持插入式模块。目前，插入式模块（例如文字输入设备 (TID)）在 Windows 上的 XINPUT 中不受支持。
XINPUT_CAPS_NO_NAVIGATION	设备缺少菜单导航按钮：START、BACK 和方向键。

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 主机

另请参阅

将 XInput 移植到 GameInput
XInputOnGameInput

(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

语法

成员

备注

要求

另请参阅