Add performance disclaimer in `SDL_GetPowerInfo` documentation

(cherry picked from commit 032d696021)
This commit is contained in:
Vittorio Romeo 2025-03-31 16:39:05 +02:00 committed by Sam Lantinga
parent 366294e1c5
commit 5db7694f22
1 changed files with 3 additions and 0 deletions

View File

@ -79,6 +79,9 @@ typedef enum SDL_PowerState
* It's possible a platform can only report battery percentage or time left
* but not both.
*
* On some platforms, retrieving power supply details might be expensive. It
* is not recommended to invoke this function every frame.
*
* \param seconds a pointer filled in with the seconds of battery life left,
* or NULL to ignore. This will be filled in with -1 if we
* can't determine a value or there is no battery.