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

另请参阅

XInput 函数

XInputGetState

XInputSetState