(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)

SDL_AllocateEventMemory

Allocate dynamic memory for an SDL event.

Header File

Defined in <SDL3/SDL_events.h>

Syntax

void * SDL_AllocateEventMemory(size_t size);

Function Parameters

Return Value

Returns a pointer to the memory allocated or NULL on failure; call SDL_GetError() for more information.

Remarks

You can use this to allocate memory for user events that will be automatically freed after the event is processed.

Thread Safety

It is safe to call this function from any thread.

Version

This function is available since SDL 3.0.0.

CategoryAPI, CategoryAPIFunction, CategoryEvents