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

# GameInputBatteryState

> GameInputBatteryState

# GameInputBatteryState

<Warning>**已弃用。** 此结构已在 GameInput v1 中移除，当前 API 中不再提供。</Warning>

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

## 语法

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

## 成员

**status**\
类型：[GameInputBatteryStatus](/reference/input/gameinput/deprecated/enums/gameinputbatterystatus)

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

**chargeRate**\
类型：float

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

**remainingCapacity**\
类型：float

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

**fullChargeCapacity**\
类型：float

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

## 备注

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

## 版本历史

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

## 另请参阅

[已弃用的 GameInput API 成员](/reference/input/gameinput/deprecated/gameinput_deprecated_members)
[GameInputBatteryStatus](/reference/input/gameinput/deprecated/enums/gameinputbatterystatus)
[IGameInputDevice::GetBatteryState](/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getbatterystate)


## Related topics

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