SDL_GetAudioStreamDevice(3)

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

💖 SDL_GetAudioStreamDevice 💖

okay bestie, welcome to the SDL3 FUNCTIONS section of the manual, we're talking about SDL_GetAudioStreamDevice(3) and honestly? it's giving "short but crucial" energy. no cap.

✨ NAME ✨

SDL_GetAudioStreamDevice — ask an audio stream which device it's currently bound to. that's it. that's the whole vibe check. 🎀

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_audio.h>

SDL_AudioDeviceID SDL_GetAudioStreamDevice(SDL_AudioStream *stream);

🦋 DESCRIPTION 🦋

so like, this one reports the logical audio device that an audio stream is currently bound to. literally just "hey stream, who's your device bestie?" 💅

and if it's not bound, or if it's invalid? it returns zero, and zero is not a valid device ID. so don't be out here treating a 0 like it's a real device, because it is NOT. it's the "nobody's home" answer. 💀

🫶 FUNCTION PARAMETERS 🫶

  • stream — the audio stream you wanna query. the one you're being nosy about. 👀

⭐ RETURN VALUE ⭐

returns the bound audio device, or 0 if it's not bound or invalid. simple as that, periodt. ✨

🧚 THREAD SAFETY 🧚

good news, gorgeous: it is safe to call this function from any thread. go off, multithreaded queen. 👑

🌈 AVAILABILITY 🌈

this function is available since SDL 3.2.0. so if you're on something older, sorry babe, no stream-device introspection for you. 😭

🔥 SEE ALSO 🔥

iykyk. go bind something. 🍓

lowkey a tiny function but highkey important — a 0 return is the "invalid" flag, don't @ me.

that's the whole page bestie, mwah 💜 — brought to you by the legends at Simple Directmedia Layer, and this cutie is from SDL 3.4.18. stay iconic, go query those streams. 💅🌸

📦 where this page comes from