hgsmi_update_pointer_shape(9)

💖 hgsmi_update_pointer_shape(9) 💖

okay bestie, so this is a page from the Kernel API Manual — yes, that Kernel API Manual — and today's main character is hgsmi_update_pointer_shape. Like the name literally spoils it: we're passing the host a brand-new mouse pointer shape via an HGSMI command. icon material only 💅✨

---

✨ NAME ✨

hgsmi_update_pointer_shape — Pass the host a new mouse pointer shape via an HGSMI command.

no cap, that's the whole personality of this function 🎀

---

🌸 SYNOPSIS 🌸

int hgsmi_update_pointer_shape (struct gen_pool *ctx , u32 flags , u32
hot_x , u32 hot_y , u32 width , u32 height , u8 *pixels , u32 len );

it's giving "long signature, big responsibilities" tbh 😭 but we love her anyway 🫶

---

🦋 ARGUMENTS 🦋

okay so here's the squad, one by one, and yes every single one matters:

• ctx — the context containing the heap to be used. think of it as the friend who brought the supplies 💜
• flags — cursor flags. flags gonna flag, yk? 🚩
• hot_x — horizontal position of the hot spot. that's the x-coordinate of the point that actually "clicks" 👑
• hot_y — vertical position of the hot spot. the y half of the same glow-up 🌈
• width — width in pixels of the cursor. measured in pixels, not vibes (sadly) 📏
• height — height in pixels of the cursor. the other dimension, serving height as always ⭐
• pixels — pixel data, see VMMDevReqMousePointer for the format. fr fr, go read that one if you wanna know the exact layout 👀
• len — size in bytes of the pixel data. don't be out here lying about your length, the host will lowkey notice 💀

---

🔥 RETURN 🔥

0 or negative errno value.

so either it ate and left no crumbs, or you get a negative errno and it's giving "not me, not today" 😭🙈

---

🧚 SEE ALSO 🧚

• Kernel file ./drivers/gpu/drm/vboxvideo/hgsmi_base.c — go touch some source code bestie 🍓
• hgsmi_report_flags_location(9)
• hgsmi_send_caps_info(9)
• hgsmi_query_conf(9)

iykyk — these three are the friendship group, and you should absolutely go read them next 💖

---

aaaand that's the whole page, no notes, absolutely slayed 🌸

cute little sign-off for the record: this lives under ./drivers/gpu/drm/vboxvideo, dated October 2026, and it's page hgsmi_update_pointer_shape(9) of the Kernel API Manual. periodt 💅🎀