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

# XINPUT_BATTERY_INFORMATION

> XINPUT_BATTERY_INFORMATION

# XINPUT\_BATTERY\_INFORMATION

バッテリーの種類と充電状態を表します。

## 構文

```cpp theme={null}
typedef struct XINPUT_BATTERY_INFORMATION {  
    BYTE BatteryType;  
    BYTE BatteryLevel;  
} XINPUT_BATTERY_INFORMATION  
```

### メンバー

*BatteryType*\
型: BYTE

バッテリーの種類を次のいずれかの値で表します。

| 値 | 説明 |
| - | - |
| BATTERY\_TYPE\_DISCONNECTED | デバイスが接続されていません。 |
| BATTERY\_TYPE\_WIRED | デバイスは有線接続であり、バッテリーはありません。 |
| BATTERY\_TYPE\_ALKALINE | デバイスにアルカリ電池が搭載されています。 |
| BATTERY\_TYPE\_NIMH | デバイスにニッケル水素 (NiMH) バッテリーが搭載されています。 |
| BATTERY\_TYPE\_UNKNOWN | デバイスのバッテリーの種類は不明です。 |

*BatteryLevel*\
型: BYTE

満充電容量に対するバッテリーの充電状態を、次のいずれかの値で表します。

| 値 | 説明 |
| - | - |
| BATTERY\_LEVEL\_EMPTY | 残量は 0 ～ 10% です。 |
| BATTERY\_LEVEL\_LOW | 残量は 10% ～ 40% です。 |
| BATTERY\_LEVEL\_MEDIUM | 残量は 40% ～ 70% です。 |
| BATTERY\_LEVEL\_FULL | 残量は 70% ～ 100% です。 |

## 解説

*BatteryLevel* の値は、バッテリーの種類が判明しているデバイスでのみ有効です。

この構造体は [XInputGetBatteryInformation](https://docs.xbox.com/ja-jp/reference/input/xinputongameinput/functions/xinputgetbatteryinformation.md) 関数で使用されます。

詳細については、[XInputOnGameInput ラッパー](https://docs.xbox.com/ja-jp/build/core-features/common/input/porting/input-porting-xinput.md#xinputWrapperSection)を参照してください。

## 要件

**ヘッダー:** XInputOnGameInput.h

**対応プラットフォーム:** XBOX One ファミリー本体および XBOX Series 本体

## 関連項目

[XInput から GameInput への移植](https://docs.xbox.com/ja-jp/build/core-features/common/input/porting/input-porting-xinput.md)\
[XInputOnGameInput](https://docs.xbox.com/ja-jp/reference/input/xinputongameinput/xinputongameinput_members.md)


## Related topics

- [XInputGetBatteryInformation](https://docs.xbox.com/ja-jp/reference/input/xinputongameinput/functions/xinputgetbatteryinformation.md)
- [XInputOnGameInput (API の内容)](https://docs.xbox.com/ja-jp/reference/input/xinputongameinput/xinputongameinput_members.md)
- [XINPUT_GAMEPAD](https://docs.xbox.com/ja-jp/reference/input/xinputongameinput/structs/xinput_gamepad.md)
- [XINPUT_CAPABILITIES](https://docs.xbox.com/ja-jp/reference/input/xinputongameinput/structs/xinput_capabilities.md)
- [XINPUT_KEYSTROKE](https://docs.xbox.com/ja-jp/reference/input/xinputongameinput/structs/xinput_keystroke.md)