XINPUT_BATTERY_INFORMATION

배터리의 유형과 충전 상태를 설명합니다.

구문

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 함수에서 사용됩니다. 자세한 내용은 XInputOnGameInput 래퍼를 참조하세요.

요구 사항

헤더: XInputOnGameInput.h 지원 플랫폼: XBOX One 제품군 콘솔 및 XBOX Series 콘솔

참고 항목

XInput에서 GameInput으로 이식
XInputOnGameInput

마지막 수정일 2026년 8월 24일

관련 항목

XInputGetBatteryInformation XInputOnGameInput XINPUT_GAMEPAD XINPUT_CAPABILITIES XINPUT_KEYSTROKE

⌘I