> ## 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](/zh-TW/reference/input/gameinput/deprecated/enums/gameinputbatterystatus)

電池目前的狀態 (例如充電中、放電中、已充飽)。

**chargeRate**\
類型：float

電池目前的充電速率，單位為 Wh。負值表示正在放電。

**remainingCapacity**\
類型：float

電池剩餘容量，單位為 Wh。

**fullChargeCapacity**\
類型：float

電池充飽時的容量，單位為 Wh。

## 備註

此結構搭配已淘汰的 [IGameInputDevice::GetBatteryState](/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getbatterystate) 方法使用，該方法已在 v1 中移除。目前的 API 中沒有直接查詢電池狀態的方式。

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v1** | 已移除。 |
| **v0** | 推出。 |

## 另請參閱

[已淘汰的 GameInput API 成員](/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members)
[GameInputBatteryStatus](/zh-TW/reference/input/gameinput/deprecated/enums/gameinputbatterystatus)
[IGameInputDevice::GetBatteryState](/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getbatterystate)


## Related topics

- [IGameInputDevice::GetBatteryState](/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getbatterystate.md)
- [GameInputBatteryStatus](/zh-TW/reference/input/gameinput/deprecated/enums/gameinputbatterystatus.md)
- [GameInput](/zh-TW/reference/input/gameinput/gameinput_members.md)
- [已淘汰的 GameInput API 成員](/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [GameInputGamepadState](/zh-TW/reference/input/gameinput/structs/gameinputgamepadstate.md)