NAME¶

SDL_HINT_THREAD_PRIORITY_POLICY - A string specifying additional information to use with SDL_SetThreadPriority .

HEADER FILE¶

Defined in SDL3/SDL_hints.h

SYNOPSIS¶

#include "SDL3/SDL.h"

#define SDL_HINT_THREAD_PRIORITY_POLICY         SDL_THREAD_PRIORITY_POLICY"

DESCRIPTION¶

By default SDL_SetThreadPriority
will make appropriate system changes in order to apply a thread priority. For example on systems using pthreads the scheduler policy is changed automatically to a policy that works well with a given priority. Code which has specific requirements can override SDL's default behavior with this hint.

pthread hint values are "current", "other", "fifo" and "rr". Currently no other platform hint values are defined but may be in the future.

On Linux, the kernel may send SIGKILL to realtime tasks which exceed the distro configured execution budget for rtkit. This budget can be queried through RLIMIT_RTTIME after calling

SDL_SetThreadPriority ().

This hint should be set before calling

SDL_SetThreadPriority ()

AVAILABILITY¶

This hint is available since SDL 3.0.0.