Skip to main content

XInputGetBatteryInformation

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

语法

参数

dwUserIndex   _In_
类型:DWORD
与设备关联的玩家索引;取值范围为 0 到 XUSER_MAX_COUNT - 1 devType   _In_
类型:BYTE
要查询的与 dwUserIndex 关联的设备类型。必须为 BATTERY_DEVTYPE_GAMEPADBATTERY_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
最后修改于 2026年8月24日