XInputGetCapabilities 函数 (xinput.h)
检索连接的控制器的功能和特性。
语法
DWORD XInputGetCapabilities(
[in] DWORD dwUserIndex,
[in] DWORD dwFlags,
[out] XINPUT_CAPABILITIES *pCapabilities
);
参数
[in] dwUserIndex
用户控制器的索引。 可以是 0-3 范围内的值。 有关如何确定此值以及如何将值映射到控制器上的指示器的信息，请参阅 多个控制器。
[in] dwFlags
标识控制器类型的输入标志。 如果此值为 0，则返回连接到系统的所有控制器的功能。 目前仅支持一个值：
| 值 | 说明 |
|---|---|
| XINPUT_FLAG_GAMEPAD | 将查询限制为控制器类型的设备。 |
以上或 0 以外的任何 dwflags 值都是非法的，在调试时将导致错误中断。
[out] pCapabilities
指向接收控制器功能的 XINPUT_CAPABILITIES 结构的指针。
返回值
如果函数成功，则返回值 ERROR_SUCCESS。
如果未连接控制器，则返回值 ERROR_DEVICE_NOT_CONNECTED。
如果函数失败，则返回值为 WinError.h 中定义的错误代码。 函数不使用 SetLastError 设置调用线程的最后错误代码。
注解
注意 Windows Vista 及更高版本中包含的旧版 XINPUT 9.1.0 (，无论附加的设备如何，) 始终返回一组固定的功能。
平台要求
Windows 8 (XInput 1.4) 、DirectX SDK (XInput 1.3) 、Windows Vista (XInput 9.1.0)要求
| 目标平台 | Windows |
| 标头 | xinput.h |
| Library | Xinput.lib;Xinput9_1_0.lib |
| DLL | Xinput1_4.dll;Xinput9_1_0.dll |