Serwis Edukacyjny
Nauczycieli
w I-LO w Tarnowie

obrazek

Materiały dla uczniów liceum

  Wyjście       Spis treści       Wstecz       Dalej  

Autor artykułu: mgr Jerzy Wałaszek
Uaktualniono: 31.07.2022

©2024 mgr Jerzy Wałaszek
I LO w Tarnowie

Interfejs SDL2:

SDL_GetPowerInfo

SPIS TREŚCI

Rozdział jest tłumaczeniem oryginalnej instrukcji dla biblioteki SDL2.

SDL_GetPowerInfo

Użyj tej funkcji, aby otrzymać szczegóły bieżącego zasilania.

Składnia

SDL_PowerState SDL_GetPowerInfo(int* secs,
                                int* pct)

Parametry funkcji

secs liczba pozostałych sekund pracy na baterii, możesz tutaj przekazać NULL, jeśli cię to nie interesuje, zwróci -1, jeśli nie można określić wartości lub system nie pracuje na baterii.
pct procent pozostałego życia baterii, pomiędzy 0 a 100, możesz przekazać tutaj NULL, jeśli cię to nie interesuje, zwróci -1, jeśli nie można określić wartości lub system nie pracuje na baterii.

Wartość zwracana

Zwraca stan baterii, jeśli jakaś jest. Zwracane wartości mogą być jak poniżej:

SDL_POWERSTATE_UNKNOWN nie można określić stanu zasilania.
SDL_PowerState.line-3">SDL_POWERSTATE_ON_BATTERY nie podłączony do sieci, praca na baterii.
SDL_PowerState.line-4">SDL_POWERSTATE_NO_BATTERY praca przy zasilaniu sieciowym, brak baterii.
SDL_PowerState.line-5">SDL_POWERSTATE_CHARGING praca przy zasilaniu sieciowym, bateria jest ładowana.
SDL_PowerState.line-6">SDL_POWERSTATE_CHARGED praca przy zasilaniu sieciowym, bateria jest naładowana.

Więcej informacji znajdziesz w opisie See SDL_PowerState.

Oba parametry zwrócą -1, jeśli wartość nie może zostać określona lub system nie pracuje na baterii.

Przykładowy kod

int secs, pct;
if (SDL_GetPowerInfo(&secs, &pct) == SDL_POWERSTATE_ON_BATTERY)
{
    printf("Battery is draining: ");
    if (secs == -1)
    {
        printf("(unknown time left)\n");
    }
    else
    {
        printf("(%d seconds left)\n", secs);
    }

    if (pct == -1)
    {
        printf("(unknown percentage left)\n");
    }
    else
    {
        printf("(%d percent left)\n", pct);
    }
}

Uwagi

Nigdy nie powinieneś całkowicie ufać stanowi baterii. Baterie (szczególnie te zużyte) są delikatnym sprzętem, a zgłaszane wartości są co najwyżej oszacowaniem opartym na tym, co zgłasza sprzęt. Stare baterie często tracą moc dużo szybciej, niż to zgłaszają, albo są całkowicie wyładowane, gdy zgłaszają, iż pozostało im jeszcze 20 procent energii, itp.

Stan baterii może ulec zmianie w każdym momencie; jeśli troszczysz się o stan zasilania, powinieneś często wywoływać tę funkcję, a ignorować zmiany, aż się ustabilizują po kilku sekundach.


Na początek:  podrozdziału   strony 

Zespół Przedmiotowy
Chemii-Fizyki-Informatyki

w I Liceum Ogólnokształcącym
im. Kazimierza Brodzińskiego
w Tarnowie
ul. Piłsudskiego 4
©2024 mgr Jerzy Wałaszek

Materiały tylko do użytku dydaktycznego. Ich kopiowanie i powielanie jest dozwolone
pod warunkiem podania źródła oraz niepobierania za to pieniędzy.

Pytania proszę przesyłać na adres email: i-lo@eduinf.waw.pl

Serwis wykorzystuje pliki cookies. Jeśli nie chcesz ich otrzymywać, zablokuj je w swojej przeglądarce.

Informacje dodatkowe.