MIX_GETAUDIODECODERPROPERTIES(3)

💖 NAME 💖

MIX_GetAudioDecoderProperties — bestie, this is the glow-up that grabs the properties hangin' off a MIX_AudioDecoder.

---

✨ SYNOPSIS ✨

#include <SDL3_mixer/SDL_mixer.h>

SDL_PropertiesID MIX_GetAudioDecoderProperties(MIX_AudioDecoder *audiodecoder);

---

🎀 DESCRIPTION 🎀

So like, SDL_mixer ships with a few properties of its own, obviously, but this is ALSO a super convenient little spot for your app to stash its own app-specific data. Think of it as your decoder's personal locker. 🫶

The very first time you call this function for a given MIX_AudioDecoder, an SDL_PropertiesID gets created — if necessary. Not me spawning property IDs on demand. 💅

The file-specific metadata you can peek at through this function is literally identical to the stuff you get from MIX_GetAudioProperties(). So if you want the deets, go read that function's documentation, okay? It's giving "same energy, different pointer." 👑

---

🌸 FUNCTION PARAMETERS 🌸

• audiodecoder — the audio decoder you're querying, bestie. That's the one.

---

⭐ RETURN VALUE ⭐

Returns a valid property ID on success, or 0 on failure. And like... if it fails, please call SDL_GetError() for more info, because guessing is not the vibe. 😭

---

🔥 THREAD SAFETY 🔥

It is safe to call this function from any thread. Yes, even that one. Go off, multithreaded main character. ✨

---

💜 AVAILABILITY 💜

This function has been available since SDL_mixer 3.0.0. Iconic behavior, honestly.

---

🦋 SEE ALSO 🦋

• MIX_GetAudioProperties(3)

---

and that's the whole page, no cap 💖✨🎀

This lil' baddie lives in the SDL_mixer manual, straight outta SDL_mixer 3.2.4 — mwah, take care of her, iykyk 💅🌈👑