AuMonitorDevice(3)

✨ AuMonitorDevice ✨

okay bestie, so this one lives in the Library Functions Manual section, page AuMonitorDevice(3). and ngl, she's a little mysterious. let's get into it 💅

---

🌸 Name 🌸

AuMonitorDevice — that's it. that's the whole name. no tagline, no little dash-description after it. the page is serving minimalism, and honestly? iconic of her.

---

🎀 Synopsis 🎀

#include <audio/audiolib.h>

AuEventHandlerRec * AuMonitorDevice(server, sample_rate, input_device,
output_device, volume, done_callback, callback_data, flow,
volume_mult_element, monitor_element, status)
    AuServer *server;
    int sample_rate;
    AuDeviceID input_device;
    AuDeviceID output_device;
    AuFixedPoint volume;
    void (*done_callback) (AuServer *, AuEventHandlerRec *, AuEvent *,
AuPointer);
    AuPointer callback_data;
    AuFlowID *flow; /* RETURN */
    int *volume_mult_element; /* RETURN */
    int *monitor_element; /* RETURN */
    AuStatus *status; /* RETURN */

so yeah, she takes a lot of arguments and hands back an AuEventHandlerRec *. the four things marked /* RETURN */ are the little gifts she gives back to you. 🎁

---

🦋 Arguments 🦋

• server — the connection to the audio server. your whole link to the party, basically.
• sample_rate — Specifies the sample rate of the

not me getting cut off mid-sentence 😭 that's genuinely where the original stops. no, i'm not making it up. the page just... ends the thought there. anyway bestie, it's the sample rate, do with that what you will 🙈

• input_device — crickets the original page gives zero description here. fr fr, it's blank. she's got main character energy but no backstory.
• output_device — also blank. no description in the source. 💀
• volume — blank too. the page said nothing. i'm not gonna invent lore for her, that's not the vibe.
• done_callback — no description given. nada. zero. the silence is loud.
• callback_data — also undescribed in the original. 🫶
• flow — undescribed, but marked /* RETURN */ in the synopsis, so she's an output, bestie.
• volume_mult_element — undescribed, and also flagged /* RETURN */.
• monitor_element — undescribed, also flagged /* RETURN */.
• status — okay THIS one actually says something! if it's non-NULL, it flushes the output buffer and returns the status from the server. slay, a girl who communicates. ⭐

---

🌈 Description 🌈

AuMonitorDevice

...and that's the entire description section. just the function name. no prose, no elaboration, no nothing. she said "you know who i am" and moved on. periodt. 💅

---

💜 Errors 💜

this section is empty. completely. the original page has the heading and then absolutely nothing underneath it. a void. a mood. 🕳️✨

---

🍓 See Also 🍓

• audiolib — Network Audio System C Language Interface

iykyk, that's your jumping-off point for everything else in the family. 🧚

---

k bye bestie, go forth and monitor those devices 💖

this lil rewrite is based on AuMonitorDevice(3), version 1.9.5, from the Library Functions Manual. no cap, that's the whole footer. 🎀🦋