XvUngrabPort(3)

📦
version 1.0.13 · 3 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, fedora 43, fedora 44, ubuntu resolute, ubuntu stonking

💖 XvUngrabPort — the "okay bestie, you can have the port back" era 💖

So this is XvUngrabPort(3) from the libXv family of functions, and honestly? It's giving release-the-grip. Let's get into it, fr fr.

✨ NAME ✨

XvUngrabPort — release a port you grabbed for video operation 🎀

✨ SYNOPSIS ✨

#include <X11/extensions/Xvlib.h>

int XvUngrabPort(Display *dpy, XvPortID port, Time time);

✨ ARGUMENTS ✨

  • dpy — the connection to the X server. your lil phone line to the server, basically 💅
  • port — the port you want released. and listen: if that port wasn't previously grabbed, the request just gets ignored. no drama, no error, it simply doesn't engage 🫶
  • time — the request timestamp. yes, timing matters here, we'll get to that 👑

✨ DESCRIPTION ✨

Okay so XvUngrabPort(3) releases a grabbed port. That's the whole job, she's a one-task queen. 💖

But here's the plot twist: if time specifies a time before the last XvGrabPort(3) was executed, the request is ignored. So if your timestamp is giving "yesterday's news", nothing happens. periodt. 🕰️

✨ RETURN VALUES ✨

  • [Success] — returned if XvUngrabPort(3) completed successfully. slay, we love a clean finish ✨
  • [XvBadExtension] — returned if the Xv extension is unavailable. like, the whole extension is just not there 😭
  • [XvBadAlloc] — returned if XvUngrabPort(3) failed to allocate memory to process the request. ran out of memory, tragic 💀

✨ DIAGNOSTICS ✨

  • [XvBadPort] — generated if the requested port does not exist. you asked for a port that simply isn't a thing, bestie 🙈

✨ SEE ALSO ✨

XvGrabPort(3) — the other half of this situationship, the one that grabs 🧚

ngl the whole vibe here is: grab it, then ungrab it, and don't be weird about timestamps. iykyk 🌸

okay that's the whole page, bestie — mwah 💋 this one comes to you from X Version 11, libXv 1.0.13, and it's an XvUngrabPort(3) original. take care of your ports, release them responsibly, and stay iconic 👑💜

📦 where this page comes from