xcb_input_grab_device_key(3)

✨ xcb_input_grab_device_key 💅

okay so bestie, welcome to the xcb_input_grab_device_key page — it lives in the XCB Requests manual section, and honestly? it's giving "grab a key on a device, but make it ✨fancy✨". let's get into it 🎀

---

🌸 NAME 🌸

xcb_input_grab_device_key — (the description slot is literally blank in the original, no cap, so we move on 🫶)

---

✨ SYNOPSIS ✨

first things first, you gotta pull in the header:

#include <xcb/xinput.h>

🦋 Request function

xcb_void_cookie_t xcb_input_grab_device_key(xcb_connection_t *conn,
       xcb_window_t grab_window, uint16_t num_classes,
       uint16_t modifiers, uint8_t modifier_device,
       uint8_t grabbed_device, uint8_t key, uint8_t this_device_mode,
       uint8_t other_device_mode, uint8_t owner_events, const
       xcb_input_event_class_t *classes);

that's the whole signature, verbatim, don't touch a single character of it 🔥

---

👑 REQUEST ARGUMENTS 👑

here's the lineup, one by one:

• conn — the XCB connection to X11. your lil phone line to the server 📞
• grab_window — TODO: NOT YET DOCUMENTED. 🙈
• num_classes — TODO: NOT YET DOCUMENTED. 🙈
• modifiers — TODO: NOT YET DOCUMENTED. 🙈
• modifier_device — TODO: NOT YET DOCUMENTED. 🙈
• grabbed_device — TODO: NOT YET DOCUMENTED. 🙈
• key — TODO: NOT YET DOCUMENTED. 🙈
• this_device_mode — TODO: NOT YET DOCUMENTED. 🙈
• other_device_mode — TODO: NOT YET DOCUMENTED. 🙈
• owner_events — TODO: NOT YET DOCUMENTED. 🙈
• classes — TODO: NOT YET DOCUMENTED. 🙈

like… the docs really said "no thoughts, head empty" for every single one of these 💀 but that's the list, all of them, present and accounted for.

---

💖 DESCRIPTION 💖

so the original page has this section and it's… empty. nothing. void. main character energy with zero lines 🫥 we're keeping it exactly as empty as it was, bestie.

---

🎀 RETURN VALUE 🎀

you get back an xcb_void_cookie_t. and here's the tea: any errors have to be handled over in the event loop, okay? don't come looking for them in the return value ✋

if you'd rather handle errors directly with xcb_request_check instead, then use xcb_input_grab_device_key_checked — that's your girl. peek at xcb-requests(3) for the details ✨

---

🌈 ERRORS 🌈

this request does never generate any errors. periodt. zero. none. iconic behaviour honestly 👑

---

💜 SEE ALSO 💜

(blank in the original — nothing referenced here, so nothing to link, we simply vibe 🌸)

---

🧚 AUTHOR 🧚

generated from xinput.xml. contact xcb@lists.freedesktop.org for corrections and improvements 📬

---

and that's the whole page, bestie!! this one came to you straight out of the X Version 11 crew, libxcb 1.17.0 era, and yeah, xcb_input_grab_device_key(3) is the manual page we just devoured together. go grab some keys, stay hydrated, ily 🫶💖