get_sound_input_cap_parm(3)

💖 get_sound_input_cap_parm(3) 💖

okay so bestie, this one lives in the Allegro manual — it's a page from the Allegro game programming library and it's literally about asking your sound card "hey girl, can you even record like this??" 🎤✨

✨ NAME ✨

get_sound_input_cap_parm — detects if the specified recording parameters are supported. Allegro game programming library. 🦋

🎀 SYNOPSIS 🎀

#include <allegro.h>

int get_sound_input_cap_parm(int rate, int bits, int stereo);

💅 DESCRIPTION 💅

so basically this function checks whether the recording frequency, the number of bits, and the mono/stereo mode you're asking for are supported by the current audio driver — and how they're supported. it's giving vibe check for your sound setup 🔥

like, you hand it the specs, it tells you what's actually possible. no cap.

🌸 RETURN VALUE 🌸

the function hands back one of these possible values, and honestly each one is a whole mood:

• 0 = it is impossible to record in this format. nope. not happening. 💀
• 1 = recording is possible, but audio output will be suspended 😭 like you can record but the playback girlies have to sit this one out.
• 2 = recording is possible at the same time as playing other sounds (full duplex sound card). iconic behavior, she can do both 👑
• -n = sampling rate not supported, but rate n would work instead. so like, not that rate bestie, but this one? yes 🫶

🦋 SEE ALSO 🦋

• start_sound_input(3)
• get_sound_input_cap_bits(3)
• get_sound_input_cap_rate(3)
• get_sound_input_cap_stereo(3)

k that's the whole page, mwah 💜 this was Allegro version 4.4.3, and yes the copyright/version energy is very much real. periodt. 💅✨🎀