通过

XInputGetBatteryInformation

  • 项目

检索无线控制器的电池类型和充电状态。

语法

DWORD XInputGetBatteryInformation(  
         DWORD dwUserIndex,  
         BYTE devType,  
         XINPUT_BATTERY_INFORMATION* pBatteryInformation  
)

参数

dwUserIndex _In_
类型：DWORD

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

devType _In_
类型：BYTE

与要查询 dwUserIndex关联的设备类型。 必须是 BATTERY_DEVTYPE_GAMEPAD 或 BATTERY_DEVTYPE_HEADSET。

pBatteryInformation _Out_
类型： XINPUT_BATTERY_INFORMATION*

指向接收电池信息的 XINPUT_BATTERY_INFORMATION 对象的指针。

返回值

类型：DWORD

如果该函数成功，则返回值为 ERROR_SUCCESS。

备注

pBatteryInformation 中返回的值指定电池的类型及充电状态。 充电状态仅对具有已知电池类型的设备有效。

有关详细信息，请参阅 XInputOnGameInput 包装器。

要求

头文件：XInputOnGameInput.h

库：xgameruntime.lib

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

另请参阅

从 XInput 移植到 GameInput
XInputOnGameInput