XInputGetCapabilities
检索连接的控制器的性能和功能。
语法
DWORD XInputGetCapabilities(
DWORD dwUserIndex,
DWORD dwFlags,
XINPUT_CAPABILITIES * pCapabilities
)
参数
dwUserIndex _In_
类型：DWORD
与设备相关联的玩家的索引；介于 0 到 XUSER_MAX_COUNT - 1 之间的值。
dwFlags _In_
类型：DWORD
标识控制器类型的输入标志。 如果该值为 0，返回连接到系统的所有控制器的功能。 目前仅支持 XINPUT_FLAG_GAMEPAD。
pCapabilities _Out_
类型： XINPUT_CAPABILITIES*
指向接收控制器功能的 XINPUT_CAPABILITIES 对象的指针。
返回值
类型：DWORD
如果该函数成功，则返回值为 ERROR_SUCCESS。
如果控制器未连接，则返回值为 ERROR_DEVICE_NOT_CONNECTED。
如果该函数失败，则返回值是在 WinError.h 中定义的错误代码。 该函数不使用 SetLastError 设置调用线程的最后错误代码。
备注
注意
旧版的 XINPUT 9.1.0 版本（包含在 Windows Vista 和更高版本中）始终会返回一组固定的功能，与所连接的设备无关。
若要详细了解报告的功能，请参阅 XINPUT_CAPABILITIES。
有关详细信息，请参阅 XInputOnGameInput 包装器。
要求
头文件：XInputOnGameInput.h
库：xgameruntime.lib
支持的平台：Xbox One 系列主机和 Xbox Series 主机