SDL_PowerState SDL_GetJoystickPowerInfo(SDL_Joystick *joystick, int *percent);
| SDL_Joystick * | joystick | 問い合わせるジョイスティック |
| int * | percent | バッテリーの残%の代入先へのポインタ. 0から100の間の間で, NULLとして無視することもできる. バッテリー残量が得られない, またはバッテリーが存在しない場合は-1が代入される |
(SDL_PowerState) 現在のバッテリー状態を戻す. 失敗のときSDL_POWERSTATE_ERRORを戻す. SDL_GetError()を呼んで詳細を知ることができる.
バッテリー状態を絶対的な真実ととらえてはならない. バッテリー(特に衰えたバッテリー)は不安定で, 報告された値はハードウェアの報告を元にした推定量でしかない. 古くなったバッテリーは報告よりも早く電力を失ったり, 20%ほど残っていると報告されても完全に失われているなどということは珍しいことではない.
この関数はどのスレッドからも安全に呼べる.