SDL_AUDIO_DEVICE_DEFAULT_RECORDING(3)

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

💖 SDL_AUDIO_DEVICE_DEFAULT_RECORDING(3) 💖

okay bestie, so this is one of those pages from the SDL3 FUNCTIONS manual set, and it's literally about one single macro that does one single thing and honestly? iconic for that. no cap. ✨

🌸 NAME 🌸

SDL_AUDIO_DEVICE_DEFAULT_RECORDING — a value you use when you wanna request a default recording audio device. that's it, that's the whole job, and she does it beautifully 💅

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_audio.h>

#define SDL_AUDIO_DEVICE_DEFAULT_RECORDING ((SDL_AudioDeviceID) 0xFFFFFFFEu)

yes the value is literally 0xFFFFFFFEu and yes it's cast to SDL_AudioDeviceID, keep it exactly like that, do not freestyle it 🫶

✨ DESCRIPTION ✨

so here's the tea: there's a bunch of functions out there that want you to hand them an SDL_AudioDeviceID. and instead of you having to go hunt down some specific device and be all "yes this one, this exact one, this is the one," you can just pass this macro instead.

what does that mean? it means you're telling SDL: bestie, you pick. the app isn't providing a specific device, it's saying "just let the system choose a default device for me." lowkey the most relatable thing in the whole library — sometimes you just don't want to make the decision and the system can have main character energy instead. 😌

so like, to recap the vibe:

  • several functions that require an SDL_AudioDeviceID will accept this value
  • passing it signifies the app just wants the system to choose a default device
  • instead of the app providing a specific one

no extra lore, no secret behaviour, that's genuinely it. fr fr.

👑 AVAILABILITY 👑

this macro has been available since SDL 3.2.0. so if you're on anything older, nope, not there, sorry babe 😭

💀 quick reminder: this is a macro, not a function, so don't be out here trying to take its address or pass it as a callback. it's a #define, and she's proud of it.

that's the whole page bestie, you're so welcome, go make some audio and slay 🦋

written by the Simple Directmedia Layer girlies, from SDL 3.4.18 — mwah, catch you on the next page 💜🎀

📦 where this page comes from