Skip to main content

XInputGetBatteryInformation

무선 컨트롤러의 배터리 유형과 충전 상태를 검색합니다.

구문

매개변수

dwUserIndex   _In_
형식: DWORD
장치와 연결된 게이머의 인덱스입니다. 값은 0에서 XUSER_MAX_COUNT - 1 범위입니다. devType   _In_
형식: BYTE
쿼리할 dwUserIndex와 연결된 장치의 유형입니다. BATTERY_DEVTYPE_GAMEPAD 또는 BATTERY_DEVTYPE_HEADSET이어야 합니다. pBatteryInformation   _Out_
형식: XINPUT_BATTERY_INFORMATION*
배터리 정보를 받는 XINPUT_BATTERY_INFORMATION 객체에 대한 포인터입니다.

반환값

형식: DWORD 함수가 성공하면 반환값은 ERROR_SUCCESS입니다.

설명

pBatteryInformation에 반환되는 값은 배터리 유형과 충전 상태를 지정합니다. 충전 상태는 알려진 배터리 유형이 있는 장치에만 유효합니다. 자세한 내용은 XInputOnGameInput 래퍼를 참조하세요.

요구 사항

헤더: XInputOnGameInput.h 라이브러리: xgameruntime.lib 지원 플랫폼: XBOX One 제품군 콘솔 및 XBOX Series 콘솔

참고 항목

XInput에서 GameInput으로 이식
XInputOnGameInput
마지막 수정일 2026년 8월 24일