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

# IGameInputDevice::GetBatteryState (已淘汰)

> IGameInputDevice::GetBatteryState

# IGameInputDevice::GetBatteryState

> [!WARNING]
>
> **已淘汰。** 此方法已在 GameInput v1 中移除，目前的 API 中無法使用。

取得裝置目前的電池狀態。

## 語法

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

### 參數

*state*   \_Out\_\
類型：[GameInputBatteryState](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/structs/gameinputbatterystate.md)\*

指向 [GameInputBatteryState](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/structs/gameinputbatterystate.md) 結構的指標，用來填入目前的電池狀態。

### 傳回值

類型：HRESULT

傳回 E\_NOTIMPL，因為此方法在 v0 中從未實作。

## 備註

此方法已在 v1 中移除。電池狀態資訊是透過 [GameInputBatteryState](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/structs/gameinputbatterystate.md) 結構提供，該結構也已移除。目前的 API 中沒有直接查詢電池狀態的方式。

## 版本歷程記錄

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

## 另請參閱

[已淘汰的 GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)\
[GameInputBatteryState](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/structs/gameinputbatterystate.md)\
[IGameInputDevice](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)


## Related topics

- [GameInputBatteryState (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/structs/gameinputbatterystate.md)
- [IGameInputDevice::SetInputSynchronizationState (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_setinputsynchronizationstate.md)
- [IGameInputDevice::SetHapticMotorState (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_sethapticmotorstate.md)
- [IGameInputDevice::SendInputSynchronizationHint (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_sendinputsynchronizationhint.md)
- [IGameInputDevice::GetRawDeviceFeature (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getrawdevicefeature.md)