AuGetElementParameters(3)

πŸ“¦ version 1.9.5, in fedora 43, fedora 44

πŸ’– AuGetElementParameters πŸ’–

okay bestie, so the manual name is AuGetElementParameters(3) β€” say it with me β€” and it's a function from the audiolib crew, and no cap it does one thing: it gets the parameters of elements in a flow. that's the NAME section, we're done, periodt. ✨


🌸 SYNTAX 🌸

like, this is literally how you call it, copy-paste ready, don't touch a single character:

#include <audio/audiolib.h>

AuBool AuGetElementParameters(server, num_parameters, parameters,
status)
    AuServer *server;
    int num_parameters;
    AuElementParameters *parameters; /* RETURN */
    AuStatus *status; /* RETURN */

note the return type is AuBool btw πŸ‘‘ and two of those args are marked /* RETURN */, meaning they get filled in for you, they're the give-not-take girlies πŸ’…


🫢 ARGUMENTS 🫢

  • server β€” the connection to the audio server. your link to the mothership, your group chat with the server, fr fr.
  • num_parameters β€” how many element parameters you want back. a number. a count. you tell it, it delivers.
  • states β€” a list of AuElementParameters structures that say which flow and which element number you want the parameters from. (and yes bestie, the SYNOPSIS above calls this one parameters β€” i'm just the messenger, i report what the page says, i do not fix it πŸ™ˆ)
  • status β€” if it's non-NULL, it flushes the output buffer and returns the status from the server. if it's NULL... it does not. that's the whole vibe check.

πŸŽ€ DESCRIPTION πŸŽ€

Not implemented.

that's it. that's the section. that's the whole thing. 😭

no cap, this function is giving "announced but never showed up to the party" energy. the documentation is out here with main character energy and the implementation is... not in the building. iconic in a tragic way tbh πŸ’€

lowkey important: since the page literally only says Not implemented., do not go assuming it does anything. it does not. do not call it expecting magic. 🚫✨

🌈 ERRORS 🌈

the page lists these, so here they are, verbatim, every single one:

  • AuBadFlow
  • AuBadLenght
  • AuBadAlloc
  • AuBadElement

(and yes, AuBadLenght is spelled exactly like that in the source, and i am NOT correcting it, that's not my job, that's not your job, we just vibe with it πŸ¦‹)


🧚 SEE ALSO 🧚

  • AuSetElementParameters β€” the setter sibling. the getter's other half. go look at it πŸ‘€
  • audiolib β€” Network Audio System C Language Interface. the whole universe this little function lives in.

πŸ’œ bye bye bestie πŸ’œ

this page came from audiolib - flow elements parameters, version 1.9.5, and the function itself is AuGetElementParameters(3). that's the source, that's the version, that's the whole footer, no gatekeeping here 🫢

now go read AuSetElementParameters and slay βœ¨πŸ’…

πŸ“¦ where this page comes from