SDL_HINT_WINDOWS_USE_D3D9EX(3)

💖 SDL_HINT_WINDOWS_USE_D3D9EX 💖

okay bestie, welcome to the SDL3 functions section, this one's a hint and it's literally about whether SDL flexes the D3D9Ex API (the glow-up one from Windows Vista) instead of plain old D3D9. 🦋

---

✨ NAME ✨

SDL_HINT_WINDOWS_USE_D3D9EX — a variable controlling whether SDL uses the D3D9Ex API introduced in Windows Vista, instead of normal D3D9. no cap, that's the whole vibe. 💅

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_hints.h>

#define SDL_HINT_WINDOWS_USE_D3D9EX "SDL_WINDOWS_USE_D3D9EX"

---

🎀 DESCRIPTION 🎀

so here's the tea, bestie: Direct3D 9Ex contains changes to state management that can eliminate device loss errors during scenarios like Alt+Tab or UAC prompts. iconic behavior honestly. 🔥

BUT. and this is a big but — D3D9Ex may require some changes to your application to cope with the new behavior, so this is disabled by default. not me warning you before you jump in 🙈

for more information on Direct3D 9Ex, see:

• https://docs.microsoft.com/en-us/windows/win32/direct3darticles/graphics-apis-in-windows-vista#direct3d-9ex
• https://docs.microsoft.com/en-us/windows/win32/direct3darticles/direct3d-9ex-improvements

the variable can be set to the following values:

• "0" — Use the original Direct3D 9 API. (default) the classic, the original, the main character before the sequel. 💜
• "1" — Use the Direct3D 9Ex API on Vista and later (and fall back if D3D9Ex is unavailable). it's giving "we'll try the fancy thing but we have a backup plan". 🫶

✨ this hint should be set before SDL is initialized. like, before. do not come to the function late, bestie, the vibe check already happened. 💀

---

🌈 AVAILABILITY 🌈

this hint is available since SDL 3.2.0. periodt. 👑

---

Simple Directmedia Layer 🎀 SDL 3.4.18 🎀 and the date is baked into the footer, so consider this your cute lil sign-off: go forth and configure your D3D9Ex hint wisely, bestie. slay, and remember to set it before init 💖✨🦋🌸💅