SDL Wiki
(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_HintCallback

A callback used to send notifications of hint value changes.

Header File

Defined in <SDL3/SDL_hints.h>

Syntax

typedef void(SDLCALL *SDL_HintCallback)(void *userdata, const char *name, const char *oldValue, const char *newValue);

Function Parameters

userdata what was passed as userdata to SDL_AddHintCallback().
name what was passed as name to SDL_AddHintCallback().
oldValue the previous hint value.
newValue the new value hint is to be set to.

Remarks

This is called an initial time during SDL_AddHintCallback with the hint's current value, and then again each time the hint's value changes.

Thread Safety

This callback is fired from whatever thread is setting a new hint value. SDL holds a lock on the hint subsystem when calling this callback.

Version

This datatype is available since SDL 3.1.3.

See Also


CategoryAPI, CategoryAPIDatatype, 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.