Function SDL_IOFromDynamicMem

pub unsafe extern "C" fn SDL_IOFromDynamicMem() -> *mut SDL_IOStream

Available on crate feature dep_sdl3 only.

Use this function to create an SDL_IOStream that is backed by dynamically allocated memory.

This supports the following properties to provide access to the memory and control over allocations:

• SDL_PROP_IOSTREAM_DYNAMIC_MEMORY_POINTER: a pointer to the internal memory of the stream. This can be set to NULL to transfer ownership of the memory to the application, which should free the memory with SDL_free(). If this is done, the next operation on the stream must be SDL_CloseIO().
• SDL_PROP_IOSTREAM_DYNAMIC_CHUNKSIZE_NUMBER: memory will be allocated in multiples of this size, defaulting to 1024.

Return value

Returns a pointer to a new SDL_IOStream structure or NULL on failure; call SDL_GetError() for more information.

Thread safety

It is safe to call this function from any thread.

Availability

This function is available since SDL 3.2.0.

See also

• SDL_CloseIO
• SDL_ReadIO
• SDL_SeekIO
• SDL_TellIO
• SDL_WriteIO