SDL_HintCallback.3type - Man Page

A callback used to send notifications of hint value changes.

Synopsis

#include <SDL3/SDL_hints.h>

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

Description

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. In the initial call, the current value is in both oldValue and 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.

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.

Availability

This datatype is available since SDL 3.2.0.

See Also

SDL_AddHintCallback(3)

Info

SDL 3.4.16 Simple Directmedia Layer SDL3 DATATYPES