AuListDevices(3)

📦 version 1.9.4, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ AuListDevices ✨

okay so bestie, welcome to AuListDevices from the Library Functions Manual — it's an audiolib thing, it lives in section 3, and it's literally just here to give you a whole list of devices. that's the whole vibe. 💖

🌸 NAME 🌸

AuListDevices — list devices 💅

🦋 SYNOPSIS 🦋

#include <audio/audiolib.h>

AuDeviceAttributes *AuListDevices(server, valuemask, attributes,
ndevices, status)
    AuServer *server;
    AuMask valuemask;
    AuDeviceAttributes *attributes;
    int *ndevices; /* RETURN */
    AuStatus *status; /* RETURN */

🎀 ARGUMENTS 🎀

  • server — the connection to the audio server. your link to the mothership fr fr 🫶
  • valuemask — tells you which device attributes are actually defined in the attributes argument. it's gotta be a bitwise inclusive OR of zero or more of these constants, no cap: AuCompCommonIDMask, AuCompCommonKindMask, AuCompCommonUseMask, AuCommonFormatMask, AuCommonNumTracksMask, AuCommonAccessMask, AuCommonDescriptionMask, AuCompDeviceMinSampleRateMask, AuCompDeviceMaxSampleRateMask, AuCompDeviceLocationMask, AuCompDeviceGainMask, AuCompDeviceLineModeMask, AuCompDeviceChildrenMask, or AuCompDeviceMasks. and like — if valuemask is zero, the attributes get fully ignored and aren't even referenced. ghosted, honestly. 💀
  • attributes — the structure where the values get taken from (the ones picked out by the value mask, obviously). 👑
  • ndevices — this one returns the number of devices in the returned list. slay. ✨
  • status — if it's non-NULL, it flushes the output buffer and returns the status straight from the server. 🧚

🌈 DESCRIPTION 🌈

AuListDevices returns a list of devices whose attributes match those values in attributes specified by valuemask. and if something went wrong? it returns NULL, with ndevices set to 0. sad but true 😭

when you're done with the list, use AuFreeDeviceList to release the memory — don't just leave it there, bestie, that's not the move. 🍓

💀 ERRORS 💀

  • AuBadLength.

💜 SEE ALSO 💜

  • AuGetDeviceAttributes.
  • audiolib — Network Audio System C Language Interface

audiolib — device attributes · version 1.9.4 · dated AuListDevices(3) 🫶 that's the whole page, bestie, go list some devices and live your main character era 💅✨

📦 where this page comes from