Wiki Page Content

SDL_AtomicLock

Use this function to lock a spin lock by setting it to a non-zero value.

Contents

  1. SDL_AtomicLock
    1. Syntax
    2. Function Parameters
    3. Code Examples
    4. Remarks
    5. Related Functions

Syntax

void SDL_AtomicLock(SDL_SpinLock* lock)

Function Parameters

lock

a pointer to a lock variable

Code Examples

You can add your code example here

Remarks

The atomic locks are efficient spinlocks using CPU instructions, but are vulnerable to starvation and can spin forever if a thread holding a lock has been terminated. For this reason you should minimize the code executed inside an atomic lock and never do expensive things like API or system calls while holding them.

/!\ The atomic locks are not safe to lock recursively.

CategoryAPI, CategoryAtomic

None: SDL_AtomicLock (last edited 2011-02-02 18:18:28 by SheenaSmith)

Feedback
Please include your contact information if you'd like to receive a reply.
Submit