SDL_GetDXGIOutputInfo(3)

📦
version 3.4.18 · 9 versions
, in fedora 43, fedora 44

💖 SDL_GetDXGIOutputInfo 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the man pages — this one is SDL_GetDXGIOutputInfo(3) and it's lowkey niche but highkey useful if you're doing Windows graphics stuff. Windows only vibes, iykyk. 🪟✨

🌸 NAME 🌸

SDL_GetDXGIOutputInfo — grab the DXGI Adapter and Output indices for the display you're pointing at. that's the whole job. slay.

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_system.h>

bool SDL_GetDXGIOutputInfo(SDL_DisplayID displayID, int *adapterIndex, int *outputIndex);

like. three args. one bool. we love a clean signature. 💅

🦋 DESCRIPTION 🦋

so here's the tea: once you have those DXGI Adapter and Output indices, you can pass them to EnumAdapters and EnumOutputs respectively — and that's how you get the objects you need to create a DX10 or DX11 device and swap chain. 🎮

basically it's the little bridge between SDL knowing about your display and DirectX knowing about your display. not me being the middleman of the graphics pipeline fr fr. 😭

✨ FUNCTION PARAMETERS ✨

  • displayID — the instance of the display you wanna query. which screen, bestie. 👀
  • adapterIndex — a pointer that gets filled in with the adapter index. it's giving "you hand me a pointer, I hand you the answer." 🫶
  • outputIndex — a pointer that gets filled in with the output index. same deal, different number. 🎀

🌈 RETURN VALUE 🌈

returns true on success or false on failure. and if it fails? call SDL_GetError() for more information — she will tell you what went wrong, no cap. 📢

👑 AVAILABILITY 👑

this function is available since SDL 3.2.0. so if you're on something older... girl. upgrade. 💀

💡 quick reminder: every single one of these details matters — the pointer types, the true/false, the SDL_GetError() call — so don't get cute and skip them, mwah. 💋

sign-off time 🎀✨ this page came to you from Simple Directmedia Layer, version SDL 3.4.18, dated with the very same <rainbow>SDL_GetDXGIOutputInfo(3)</rainbow> energy it started with. stan the man pages, bestie, they love you. 💜🦋💅

📦 where this page comes from