Skip to main content

XInputGetDeviceId

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

语法

参数

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
最后修改于 2026年8月24日