SDL Wiki
(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

const char * name the hint to watch.
SDL_HintCallback callback an SDL_HintCallback function that will be called when the hint value changes.
void * userdata a pointer to pass to the callback function.

Return Value

(int) Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.

Thread Safety

It is NOT safe to call this function from two threads at once.

Version

This function is available since SDL 3.0.0.

See Also


CategoryAPI, CategoryAPIFunction, CategoryHints


[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.