AuRegisterEventHandler(3)

✨ AuRegisterEventHandler ✨

okay bestie, welcome to the AuRegisterEventHandler(3) page 💖 this one lives in the Library Functions Manual and it's literally about teaching the audio server who's gonna handle your events. so iconic. let's get into it 🎀

🌸 SYNOPSIS 🌸

#include <audio/audiolib.h>

AuEventHandlerRec *AuRegisterEventHandler(server, value_mask, type, id,
callback data)
    AuServer *server;
    AuMask value_mask;
    int type;
    AuID id;
    AuBool (*callback)(AuServer *, AuEvent *, AuEventHandlerRec *);
    AuPointer data;

no cap, that's the whole signature. she's giving "one function, six arguments, zero chill" 💅

🦋 ARGUMENTS 🦋

• server — the connection to the audio server, aka your lil phone line to the sound gods 🔥
• value_mask — tells the function which values get checked to figure out whether this handler should be the one handling an event. it should be an inclusive OR of AuEventHandlerTypeMask and AuEventHandlerIDMask. so like, both of them, together, slaying ✨
• type — the type of event this handler is gonna handle. should be one of these constants:
  • AuEventTypeElementNotify
  • AuEventTypeGrabNotify
  • AuEventTypeMonitorNotify

pick your fighter 👑

• id — the source id of the event that this handler is gonna handle. yes it's a mystery id, no we don't ask questions 🙈
• callback — the procedure that actually handles the event. this is the main character of the whole operation tbh 🫶
• data — extra data you wanna pass along to the event handler. lil gift bag of info 🎀

💜 DESCRIPTION 💜

AuRegisterEventHandler registers an event handler for future use by AuDispatchEvent. that's it, that's the whole thing. she sets it up now so it's ready to go later. lowkey the most reliable bestie in the whole library 🌈

🌟 SEE ALSO 🌟

• AuUnregisterEventHandler — for when you gotta say bye 👋
• audiolib — Network Audio System C Language Interface

and that's the vibe check, bestie! 💖 this page came from the audioutil source, version 1.9.5, in the Library Functions Manual — go forth and register those handlers, you absolute icon 🧚💅✨