SDL_InitState(3type)

NAME
SDL_InitState - A structure used for thread-safe initialization and shutdown.

HEADER FILE
Defined in SDL3/SDL_mutex.h

SYNOPSIS
#include "SDL3/SDL.h"

typedef struct SDL_InitState
{
    SDL_AtomicInt status;
    SDL_ThreadID thread;
    void *reserved;
} SDL_InitState;

DESCRIPTION
Here is an example of using this:

           static SDL_AtomicInitState init;

           bool InitSystem(void)
           {
               if (!SDL_ShouldInit(&init)) {
                   // The system is initialized
                   return true;
               }

               // At this point, you should not leave this function without calling SDL_SetInitialized()

               bool initialized = DoInitTasks();
               SDL_SetInitialized(&init, initialized);
               return initialized;
           }

           bool UseSubsystem(void)
           {
               if (SDL_ShouldInit(&init)) {
                   // Error, the subsystem isn't initialized
                   SDL_SetInitialized(&init, false);
                   return false;
               }

               // Do work using the initialized subsystem

               return true;
           }

           void QuitSystem(void)
           {
               if (!SDL_ShouldQuit(&init)) {
                   // The system is not initialized
                   return;
               }

               // At this point, you should not leave this function without calling SDL_SetInitialized()

               DoQuitTasks();
               SDL_SetInitialized(&init, false);
           }

Note that this doesn't protect any resources created during initialization, or guarantee that nobody is using those resources during cleanup. You should use other mechanisms to protect those, if that's a concern for your code.

AVAILABILITY
This struct is available since SDL 3.2.0.