> ## 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.

# IGameInputDevice::GetBatteryState

> IGameInputDevice::GetBatteryState

# IGameInputDevice::GetBatteryState

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

获取设备的当前电池状态。

## 语法

```cpp theme={null}
HRESULT GetBatteryState(
    GameInputBatteryState* state
);
```

### 参数

*state*   \_Out\_\
类型：[GameInputBatteryState](/reference/input/gameinput/deprecated/structs/gameinputbatterystate)\*

指向要用当前电池状态填充的 [GameInputBatteryState](/reference/input/gameinput/deprecated/structs/gameinputbatterystate) 结构的指针。

### 返回值

类型：HRESULT

返回 E\_NOTIMPL，因为此方法在 v0 中从未实现。

## 备注

此方法已在 v1 中移除。电池状态信息之前通过 [GameInputBatteryState](/reference/input/gameinput/deprecated/structs/gameinputbatterystate) 结构提供，该结构也已被移除。当前 API 中不存在直接的电池状态查询。

## 版本历史

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

## 另请参阅

[已弃用的 GameInput API 成员](/reference/input/gameinput/deprecated/gameinput_deprecated_members)\
[GameInputBatteryState](/reference/input/gameinput/deprecated/structs/gameinputbatterystate)\
[IGameInputDevice](/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)


## Related topics

- [GameInputBatteryState](/zh-CN/reference/input/gameinput/deprecated/structs/gameinputbatterystate.md)
- [IGameInputDevice::SetInputSynchronizationState](/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_setinputsynchronizationstate.md)
- [IGameInputDevice::SetHapticMotorState](/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_sethapticmotorstate.md)
- [IGameInputDevice::GetRawDeviceFeature](/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getrawdevicefeature.md)
- [已弃用的 GameInput API 成员](/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)