A function pointer used for callbacks that watch the event queue.
Defined in <SDL3/SDL_events.h>
typedef bool (SDLCALL *SDL_EventFilter)(void *userdata, SDL_Event *event);
userdata | what was passed as userdata to SDL_SetEventFilter() or SDL_AddEventWatch, etc. |
event | the event that triggered the callback. |
Returns true to permit event to be added to the queue, and false to disallow it. When used with SDL_AddEventWatch, the return value is ignored.
SDL may call this callback at any time from any thread; the application is responsible for locking resources the callback touches that need to be protected.
This datatype is available since SDL 3.0.0.