XInputGetDeviceId

检索指定控制器的设备 ID。

语法

DWORD XInputGetDeviceId(  
         DWORD dwUserIndex,  
         APP_LOCAL_DEVICE_ID * pDeviceId  
)  

参数

dwUserIndex _In_
类型:DWORD

与设备相关联的玩家的索引;介于 0 到 XUSER_MAX_COUNT - 1 之间的值。

pDeviceId _Out_
类型:APP_LOCAL_DEVICE_ID*

指定用户索引处的设备 ID。

返回值

类型:DWORD

如果该函数成功检索设备 ID,则返回 ERROR_SUCCESS

如果控制器未连接,则该函数将返回 ERROR_DEVICE_NOT_CONNECTED

如果函数失败,它将返回一个 Win32 错误代码。

备注

应用程序本地设备 ID 唯一地标识设备,即使在重新启动游戏或系统时也是如此。 有关详细信息,请参阅 设备 ID

有关使用 XInputOnGameInput 的更多信息,请参阅 XInputOnGameInput 包装器。

要求

头文件:XInputOnGameInput.h

库:xgameruntime.lib

支持的平台:Xbox One 系列主机和 Xbox Series 主机

另请参阅

从 XInput 移植到 GameInput
XInputOnGameInput