> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GameInputBatteryState（已弃用）

> GameInputBatteryState

# GameInputBatteryState

> [!WARNING]
>
> **已弃用。** 此结构已在 GameInput v1 中移除，当前 API 中不再提供。

描述输入设备的当前电池状态。

## 语法

```cpp theme={null}
typedef struct GameInputBatteryState {
    GameInputBatteryStatus status;
    float chargeRate;
    float remainingCapacity;
    float fullChargeCapacity;
} GameInputBatteryState;
```

## 成员

**status**\
类型：[GameInputBatteryStatus](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputbatterystatus.md)

电池的当前状态（例如充电中、放电中、已充满）。

**chargeRate**\
类型：float

电池的当前充电率（单位：Wh）。负值表示放电。

**remainingCapacity**\
类型：float

电池的剩余容量（单位：Wh）。

**fullChargeCapacity**\
类型：float

电池的满充容量（单位：Wh）。

## 备注

此结构曾与已弃用的 [IGameInputDevice::GetBatteryState](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getbatterystate.md) 方法一起使用，该方法已在 v1 中移除。当前 API 中不存在直接的电池状态查询。

## 版本历史

| 版本 | 变更 |
| - | - |
| **v1** | 已移除。 |
| **v0** | 已引入。 |

## 另请参阅

[已弃用的 GameInput API 成员](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
[GameInputBatteryStatus](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputbatterystatus.md)
[IGameInputDevice::GetBatteryState](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getbatterystate.md)


## Related topics

- [GameInputBatteryStatus（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputbatterystatus.md)
- [IGameInputDevice::GetBatteryState（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getbatterystate.md)
- [已弃用的 GameInput API 成员](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [GameInputMotionState（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputmotionstate.md)
- [GameInputTouchState（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputtouchstate.md)