xcb_xv_query_adaptors(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_xv_query_adaptors ✨

okay bestie, welcome to xcb_xv_query_adaptors(3) πŸ’– this is one of the XCB Requests girlies, and she's here to let you ask the X11 server "hey… what adaptors do we have?" no cap. it lives in the xv extension corner of libxcb, and honestly? she's giving very "quiet but essential" energy. 🌸


🌈 SYNOPSIS

first up, include the thing or nothing works, periodt:

#include <xcb/xv.h>

πŸŽ€ Request function

xcb_xv_query_adaptors_cookie_t
       xcb_xv_query_adaptors(xcb_connection_t *conn,
       xcb_window_t window);

πŸ¦‹ Reply datastructure

this is the lil struct the server hands back, look at her:

typedef struct xcb_xv_query_adaptors_reply_t {
    uint8_t  response_type;
    uint8_t  pad0;
    uint16_t sequence;
    uint32_t length;
    uint16_t num_adaptors;
    uint8_t  pad1[22];
} xcb_xv_query_adaptors_reply_t;

πŸ’œ Reply function

xcb_xv_query_adaptors_reply_t
       *xcb_xv_query_adaptors_reply(xcb_connection_t *conn,
       xcb_xv_query_adaptors_cookie_t cookie, xcb_generic_error_t **e);

🌟 Reply accessors

these are the lil helpers that peek inside the reply for you, iykyk:

int xcb_xv_query_adaptors_info_length(const
       xcb_xv_query_adaptors_reply_t *reply);

xcb_xv_adaptor_info_iterator_t xcb_xv_query_adaptors_info_iterator(const
       xcb_xv_query_adaptors_reply_t *reply);

🌸 REQUEST ARGUMENTS

  • conn β€” your XCB connection to X11, aka the lil phone line to the server. literally the whole reason any of this works. 🫢
  • window β€” TODO: NOT YET DOCUMENTED. yeah bestie, the docs said "we'll get to it" and then never did 😭 it's a window, that's the vibe, that's all we got.

πŸ’… REPLY FIELDS

  • response_type β€” the type of this reply, which in this case is XCB_XV_QUERY_ADAPTORS. this field also chills in the xcb_generic_reply_t, so you can use it to tell replies apart from each other. it's the name tag at the party πŸŽ€
  • sequence β€” the sequence number of the last request processed by the X11 server. so you always know where you are in the timeline ⏳
  • length β€” the length of the reply, in words. and because someone WILL ask: a word is 4 bytes. iconic unit choice, no notes ✨
  • num_adaptors β€” TODO: NOT YET DOCUMENTED. again!! the mystery continues πŸ•΅οΈβ™€οΈ it's a count of adaptors, that's the tea we have.

πŸ’€ DESCRIPTION

nothing here bestie. the DESCRIPTION section is literally empty. an empty canvas. a blank page. we simply do not have description lore today πŸ™ˆ


πŸ”₯ RETURN VALUE

Returns an xcb_xv_query_adaptors_cookie_t. πŸͺ

errors have to be handled when you call the reply function xcb_xv_query_adaptors_reply.

but if you'd rather handle errors in the event loop instead, use xcb_xv_query_adaptors_unchecked. see xcb-requests(3) for the details, bestie, it's all there πŸ‘‘

🧚 ERRORS

This request does never generate any errors. not one. zero. she's unproblematic and we LOVE that for her πŸ’–βœ¨


πŸ‘‘ SEE ALSO

empty. nothing. the SEE ALSO section is a void and we respect her privacy 🌌


🌈 AUTHOR

Generated from xv.xml. Contact xcb@lists.freedesktop.org for corrections and improvements. like, fr fr, if something's wrong, tell them, they're nice 🫢


okay that's the whole page, you ate that, go forth and query those adaptors πŸ’…βœ¨

big kisses from X Version 11, libxcb 1.17.0 πŸŽ€ the manual page header said xcb_xv_query_adaptors(3) and yes she's still that girl πŸ’– mwah, bye bestie!! πŸŒΈπŸ¦‹πŸ’œ