SDL_GetAudioDeviceName(3)

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

💖 SDL_GetAudioDeviceName 💖

okay bestie, welcome to the SDL_GetAudioDeviceName(3) page — it lives in the SDL3 FUNCTIONS collection and it's literally just "hey, what's this audio device called?" 🎀

✨ NAME ✨

SDL_GetAudioDeviceName — get the human-readable name of a specific audio device. that's it, that's the whole job, and she does it flawlessly. 💅

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_audio.h>

const char * SDL_GetAudioDeviceName(SDL_AudioDeviceID devid);

🦋 DESCRIPTION 🦋

⚠️ WARNING, bestie, listen up: this function will work with SDL_AUDIO_DEVICE_DEFAULT_PLAYBACK and SDL_AUDIO_DEVICE_DEFAULT_RECORDING, returning the current default physical devices' names. BUT. the default device may change at any time, so it's probably better to just show the user a generic name, like "System default audio device" or maybe "default [currently %s]". 🙈

and do NOT store this name to disk to reidentify the device in a later run of the program — because the default might change in general, and the string will be the name of a specific device, not the abstract system default. it's giving "that's not the same girl anymore" energy fr fr. 😭

🎀 FUNCTION PARAMETERS 🎀

  • devid — the instance ID of the device to query. just the ID, nothing scary. ✨

💜 RETURN VALUE 💜

Returns the name of the audio device, or NULL on failure. and if it fails? call SDL_GetError() for more info, she'll tell you what went wrong. 🫶

🌈 THREAD SAFETY 🌈

It is safe to call this function from any thread. ANY THREAD. go off, multithreaded icon. 👑

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. so if you're on anything older, no name for you, sorry babe. 💀

🔥 SEE ALSO 🔥

iykyk — go read those next, bestie. 🍓

k bye, this has been your girl from the Simple Directmedia Layer, dropping the SDL 3.4.18 build of SDL_GetAudioDeviceName(3) — slay, stay hydrated, and check your return values. 💖✨🧚

📦 where this page comes from