AuSetDeviceAttributes(3)

💖 AuSetDeviceAttributes — like, the audiolib glow-up for your device settings ✨

okay bestie, so this is a page from the audiolib manual (section 3, library functions, iykyk) and it's literally all about changing how a device on the Network Audio System behaves. it's giving "makeover montage but for audio hardware" 💅

---

🌸 NAME 🌸

AuSetDeviceAttributes — set device attributes 🎀

---

✨ SYNOPSIS ✨

#include <audio/audiolib.h>

void AuSetDeviceAttributes(server, device, valuemask, attributes,
status)
    AuServer *server;
    AuDeviceID device;
    AuMask valuemask;
    AuDeviceAttributes *attributes;
    AuStatus *status; /* RETURN */

no cap, that's the whole signature. write it down, it's important 🫶

---

🦋 ARGUMENTS 🦋

• server — the connection to the audio server. like, your lil hotline to the server, that's what this is.
• device — the ID of the device. yes queen, you gotta say which device.
• valuemask — specifies which values in attributes to used. (yes, the original says "to used", we're keeping it, it's canon 💀) it has to be a bitwise inclusive OR of one or more of these constants:
  • AuCompCommonIDMask
  • AuCompCommonKindMask
  • AuCompCommonUseMask
  • AuCommonFormatMask
  • AuCommonNumTracksMask
  • AuCommonAccessMask
  • AuCommonDescriptionMask
  • AuCompDeviceGainMask
  • AuCompDeviceLineModeMask
• attributes — the structure you're pulling the values from. which values? the ones the value mask told you about, bestie. that's the whole system.
• status — if it's non-NULL, it flushes the output buffer and returns the status from the server. so like, if you actually wanna know how it went, don't pass NULL 🙈

---

🌈 DESCRIPTION 🌈

AuSetDeviceAttributes sets the attributes of device using only those values in attributes specified by valuemask. it does not go rogue. it does not touch extra stuff. it does exactly what the mask says, periodt.

⚠️ real talk though: trying to change attributes that aren't marked as changable will fail with a AuBadValue error. so like, vibe check the device first, okay? 😭

---

💀 ERRORS 💀

AuBadDevice, AuBadLength, AuBadValue.

that's the trio. if one of these shows up, that's the universe telling you something.

---

👑 SEE ALSO 👑

AuGetDeviceAttributes — the read-only counterpart, for when you just wanna look 👀

audiolib — Network Audio System C Language Interface

---

and that's the page, bestie! this one's from the audiolib manual, page AuSetDeviceAttributes(3), version 1.9.5, filed under "device attributes" — mwah, iconic, go slay your audio setup 💖✨🎀