Skip to main content

​
XInputGetBatteryInformation

Recupera o tipo de bateria e o status de carga de um controle sem fio.

​
Sintaxe

​
Parâmetros

dwUserIndex   _In_
Tipo: DWORD Índice do jogador associado ao dispositivo; um valor no intervalo de 0 a XUSER_MAX_COUNT - 1. devType   _In_
Tipo: BYTE O tipo de dispositivo associado a dwUserIndex a ser consultado. Deve ser BATTERY_DEVTYPE_GAMEPAD ou BATTERY_DEVTYPE_HEADSET. pBatteryInformation   _Out_
Tipo: XINPUT_BATTERY_INFORMATION* Ponteiro para um objeto XINPUT_BATTERY_INFORMATION que recebe as informações da bateria.

​
Valor retornado

Tipo: DWORD Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

​
Comentários

Os valores retornados em pBatteryInformation especificam o tipo de bateria e o estado de sua carga. O estado de carga é válido apenas para um dispositivo que tenha um tipo de bateria conhecido. Para obter mais informações, consulte O wrapper XInputOnGameInput.

​
Requisitos

Cabeçalho: XInputOnGameInput.h Biblioteca: xgameruntime.lib Plataformas com suporte: consoles da família XBOX One e consoles XBOX Series

​
Confira também

Portabilidade do XInput para o GameInput
XInputOnGameInput
Last modified on October 6, 2026