NAME
SDL_AddHintCallback - Add a function to watch a particular hint.
HEADER FILE
Defined in SDL3/SDL_hints.h
SYNOPSIS
#include "SDL3/SDL.h"
bool SDL_AddHintCallback(const char *name, SDL_HintCallback callback, void *userdata);
DESCRIPTION
The callback function is called _during_ this function, to provide it an initial value, and again each time the hint's value changes.
FUNCTION PARAMETERS
- name
-
the hint to watch.
- callback
-
An SDL_HintCallback
function that will be called when the hint value changes.
- userdata
-
a pointer to pass to the callback function.
RETURN VALUE
Returns true on success or false 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.