SDL_MUSTLOCK

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

Składnia

#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

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:

#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_UnlockSurface	Zdejmuje blokadę dostępu z określonej powierzchni. (funkcja)
SDL_LockSurface	Blokuje innym wątkom dostęp do powierzchni. (funkcja)
SDL_FreeSurface	Zwalnia pamięć zajmowaną przez powierzchnię. (funkcja)
SDL_Surface	Przechowuje informacje o powierzchni. (struktura)

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.