Biblioteki C/C++
SDL_LockSurface
[funkcja] Blokuje innym wątkom dostęp do powierzchni.Skdładnia
#include <sdl/SDL.h>
int SDL_LockSurface( SDL_Surface * surface );
Opis szczegółowy
Funkcja blokuje innym wątkom dostęp do powierzchni. Zakładanie blokady na powierzchnię jest konieczne jeżeli jest ona używana i chcemy ją zmodyfikować. Niezałożenie blokady może zakończyć się krytycznym błędem aplikacji w przypadku próby modyfikacji powierzchni. Wszelkie modyfikacje powierzchni powinny odbywać się pomiędzy funkcjami
SDL_LockSurface i
SDL_UnlockSurface.
Argumenty
Zwracana wartość
W przypadku wystapienia błędu funkcja zwraca wartość
-1, w przeciwnym wypadku wartość
0.
Dodatkowe informacje
Pamiętaj, że nie wszystkie powierzchnie muszą być zablokowane przed uzyskaniem dostępu do nich. Blokada powierzchni jest konieczna tylko wtedy gdy funkcja
SDL_MUSTLOCK zwróci wartość różną od
0.
Od wersji SDL 1.1.8 blokowanie powierzchni odbywa się rekursywnie. Oznacza to, że powierzchnia może być zablokowana wiele razy, jednak każde zablokowanie
musi zostać odblokowane.
Przykład
SDL_Surface * someSurface = NULL;
SDL_LockSurface( someSurface );
SDL_LockSurface( someSurface );
SDL_UnlockSurface( someSurface );
SDL_UnlockSurface( someSurface );
Zagadnienia powiązane
| SDL_MUSTLOCK | Zwraca prawdę, jeżeli wymagane jest założenie blokady przed uzyskaniem dostępu do powierzchni. (funkcja) |
|---|
| SDL_UnlockSurface | Zdejmuje blokadę dostępu z określonej powierzchni. (funkcja) |
|---|
| SDL_Surface | Przechowuje informacje o powierzchni. (struktura) |
|---|
Linki zewnętrzne
Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem
jest zabronione.
Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.