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

Draft

THIS PAGE IS A WORK IN PROGRESS ... Please make edits to this page to improve it!

SDL_AddHintCallback

Add a function to watch a particular hint.

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.


CategoryAPI, CategoryHints, CategoryDraft