Panel użytkownika
Nazwa użytkownika:
Hasło:
Nie masz jeszcze konta?
Opracował: kamillo121
Udoskonalił: Piotr DejaVu Szawdyński
Biblioteki C/C++

SDL_MUSTLOCK

[funkcja] Zwraca prawdę, jeżeli wymagane jest założenie blokady przed uzyskaniem dostępu do powierzchni.

Składnia

C/C++
#include <sdl/SDL.h>

int SDL_MUSTLOCK( SDL_Surface * surface );

Opis szczegółowy

Makro zwraca prawdę, jeżeli wymagane jest założenie blokady przed uzyskaniem dostępu do powierzchni.

Argumenty

SDL_Surface* surface Wskaźnik na strukturę SDL_Surface.

Zwracana wartość

Funkcja zwraca wartość 1 jeżeli blokowanie jest konieczne przed uzyskaniem dostępu do powierzchni. W przeciwnym wypadku funkcja zwróci wartość równą 0.

Przyklad

C/C++
SDL_Surface * someSurf = NULL;
//(...)
if( SDL_MUSTLOCK( someSurf ) )
SDL_LockSurface( someSurf )

//operacje na powierzchni
if( SDL_MUSTLOCK( someSurf ) )
     SDL_UnlockSurface( someSurf );

SDL_FreeSurface( someSurf );

//(...)

Dodatkowe informacje

Funkcja może występować w kodzie w postaci następującego makra:
C/C++
#define SDL_MUSTLOCK(surface) (surface->offset ||    ((surface->flags & (SDL_HWSURFACE|SDL_ASYNCBLIT|SDL_RLEACCEL)) != 0))

Niezablokowanie dostępu do powierzchni gdy jest to wymagane spowoduje błąd krytyczny aplikacji.

Zagadnienia powiązane

SDL_UnlockSurfaceZdejmuje blokadę dostępu z określonej powierzchni. (funkcja)
SDL_LockSurfaceBlokuje innym wątkom dostęp do powierzchni. (funkcja)
SDL_FreeSurfaceZwalnia pamięć zajmowaną przez powierzchnię. (funkcja)
SDL_SurfacePrzechowuje informacje o powierzchni. (struktura)