XvSelectPortNotify(3)

💅 XvSelectPortNotify — the libXv glow-up your port notifications needed

okay bestie, welcome to XvSelectPortNotify(3), a lil function from the libXv family (that's the X Video Extension library, for the uninitiated 🎀). She does one thing and she does it well: turning XvPortNotify events on and off. That's it. That's the girl. ✨

---

✨ NAME ✨

XvSelectPortNotify — enable or disable XvPortNotify events 💖

---

🌸 SYNOPSIS 🌸

#include <X11/extensions/Xvlib.h>

int XvSelectPortNotify(Display *dpy, XvPortID port, Bool onoff);

---

🦋 ARGUMENTS 🦋

• dpy — your connection to the X server. the group chat, basically. you gotta be plugged in to talk. 💜
• port — the specific port you're obsessed with. this is the port that'll start generating PortNotify events whenever its attributes get changed via XvSetPortAttribute(3). 👑
• onoff — the switch. are we enabling the notification or disabling it? Bool, so it's giving true/false energy. no in-between. 💅

---

🧚 DESCRIPTION 🧚

so like, XvSelectPortNotify(3) enables or disables PortNotify event delivery to the client that's asking. that's the whole vibe.

and when do those events actually show up? XvPortNotify(3) events get generated whenever port attributes are changed using XvSetPortAttribute(3). so if you want the receipts when someone messes with your port's attributes, this is the function you call first. periodt. ✨

---

💖 RETURN VALUES 💖

• [Success] — returned if XvSelectPortNotify(3) completed successfully. slay, we love a clean run. 🎀
• [XvBadExtension] — returned if the Xv extension is unavailable. 😭 the extension ghosted you.
• [XvBadAlloc] — returned if XvSelectPortNotify(3) failed to allocate memory to process the request. she's out of RAM, bestie. 💀

---

🌈 DIAGNOSTICS 🌈

• [XvBadPort] — generated if the requested port does not exist. that port is not real, girl. it never was. 🙈

---

👑 SEE ALSO 👑

• XvSetPortNotify(3)
• XvSetPortAttribute(3)
• XvPortNotify(3)

---

ngl, if you're here you probably also want XvSetPortAttribute(3) — that's the one actually triggering the events you're signing up for. iykyk. 💅

---

okay that's the whole page, you ate it up, go forth and notify responsibly 🫶

this was brought to you by X Version 11, specifically libXv 1.0.13 — stay iconic, stay compiled, and don't forget to #include <X11/extensions/Xvlib.h> bestie 💜✨