table of contents
- testing 3.2.4+ds-2
- unstable 3.2.4+ds-2
- experimental 3.2.4+git20250218+ds-1
SDL_SignalAsyncIOQueue(3) | SDL3 FUNCTIONS | SDL_SignalAsyncIOQueue(3) |
NAME¶
SDL_SignalAsyncIOQueue - Wake up any threads that are blocking in SDL_WaitAsyncIOResult ().
HEADER FILE¶
Defined in SDL3/SDL_asyncio.h
SYNOPSIS¶
#include "SDL3/SDL.h"
void SDL_SignalAsyncIOQueue(SDL_AsyncIOQueue *queue);
DESCRIPTION¶
This will unblock any threads that are sleeping in a call to
SDL_WaitAsyncIOResult
for the specified queue, and cause them to return from that function.
This can be useful when destroying a queue to make sure nothing is touching it indefinitely. In this case, once this call completes, the caller should take measures to make sure any previously-blocked threads have returned from their wait and will not touch the queue again (perhaps by setting a flag to tell the threads to terminate and then using
SDL_WaitThread () to make sure they've done so).
FUNCTION PARAMETERS¶
- queue
- the async I/O task queue to signal.
THREAD SAFETY¶
It is safe to call this function from any thread.
AVAILABILITY¶
This function is available since SDL 3.2.0.
SEE ALSO¶
•(3), SDL_WaitAsyncIOResult(3)
SDL 3.2.4 | Simple Directmedia Layer |