xcb_dri2_get_msc(3)

📦
version 1.17.0 · 4 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, centos-stream 10, debian trixie, fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 xcb_dri2_get_msc(3) — XCB Requests 💖

okay bestie, so this is a page from the XCB Requests manual, and yes it lives in section 3, and yes it's giving "generated from an XML file at 2am" energy but we're gonna make it cute. It's the xcb_dri2_get_msc request from libxcb — the DRI2 "hey server, what's your media stream counter rn" situation. Let's get into it 🎀

✨ NAME ✨

xcb_dri2_get_msc —

lowkey the description here is literally empty in the source, so like... that's the whole vibe. no cap, there's nothing after the dash. 🙈

✨ SYNOPSIS ✨

First things first, you gotta pull in the header:

#include <xcb/dri2.h>

🦋 Request function 🦋

xcb_dri2_get_msc_cookie_t xcb_dri2_get_msc(xcb_connection_t *conn,
       xcb_drawable_t drawable);

🦋 Reply datastructure 🦋

typedef struct xcb_dri2_get_msc_reply_t {
    uint8_t  response_type;
    uint8_t  pad0;
    uint16_t sequence;
    uint32_t length;
    uint32_t ust_hi;
    uint32_t ust_lo;
    uint32_t msc_hi;
    uint32_t msc_lo;
    uint32_t sbc_hi;
    uint32_t sbc_lo;
} xcb_dri2_get_msc_reply_t;

🦋 Reply function 🦋

xcb_dri2_get_msc_reply_t *xcb_dri2_get_msc_reply(xcb_connection_t *conn,
       xcb_dri2_get_msc_cookie_t cookie, xcb_generic_error_t **e);

🌸 REQUEST ARGUMENTS 🌸

  • conn — your XCB connection to X11. the whole lifeline, the main character, the reason any of this works 💅
  • drawable — TODO: NOT YET DOCUMENTED. yeah bestie, the docs said "idk" on this one. iconic of them honestly. 🫠

🌈 REPLY FIELDS 🌈

  • response_type — the type of this reply, and in this case it's XCB_DRI2_GET_MSC. This field also shows up in the xcb_generic_reply_t, so you can use it to tell your replies apart from each other. it's the little name tag at the party 🏷️
  • sequence — the sequence number of the last request the X11 server processed. tracking numbers but for requests ✨
  • length — the length of the reply, in words (and a word is 4 bytes, so do the math bestie 🧮)
  • ust_hi — TODO: NOT YET DOCUMENTED.
  • ust_lo — TODO: NOT YET DOCUMENTED.
  • msc_hi — TODO: NOT YET DOCUMENTED.
  • msc_lo — TODO: NOT YET DOCUMENTED.
  • sbc_hi — TODO: NOT YET DOCUMENTED.
  • sbc_lo — TODO: NOT YET DOCUMENTED.

the hi/lo pairs are all just sitting there undocumented, minding their own business, thriving 💜

🎀 DESCRIPTION 🎀

bestie. there is nothing here. the DESCRIPTION section is empty. it's giving blank canvas, it's giving "we'll fill this in later", it's giving absolutely nothing and honestly? we respect the confidence. 💀

⭐ RETURN VALUE ⭐

It hands you back an xcb_dri2_get_msc_cookie_t — a little cookie, a little promise, a little IOU 🍪

Errors? Those have to be handled when you call the reply function, xcb_dri2_get_msc_reply.

But if you'd rather handle your errors in the event loop instead (very valid, very you), then use xcb_dri2_get_msc_unchecked. Peep xcb-requests(3) for the deets.

💀 ERRORS 💀

This request does never generate any errors. not one. zero. it's a well-behaved king 👑

🌟 SEE ALSO 🌟

...it's empty. nothing to see here. literally. no references, no friends, no mutuals. a lone wolf. 🐺

👑 AUTHOR 👑

Generated from dri2.xml. Wanna send corrections or improvements? Contact xcb@lists.freedesktop.org — they're the ones to @, fr fr. 🫶

and that's the whole page babes!! this one came from X Version 11, shipped with libxcb 1.17.0, and it's the xcb_dri2_get_msc(3) page — so next time someone asks you about your media stream counter you can just say "iykyk" and point them here. slay, periodt, stay hydrated 💅✨🌸

📦 where this page comes from