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

SDL_AddHintCallback

Add a function to watch a particular hint.

Header File

Defined in <SDL3/SDL_hints.h>

Syntax

int SDL_AddHintCallback(const char *name,
                    SDL_HintCallback callback,
                    void *userdata);

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 0 on success or a negative error code on failure; call SDL_GetError() for more information.

Version

This function is available since SDL 3.0.0.

See Also


CategoryAPI, CategoryAPIFunction, CategoryHints