vmw_cmd_emit_dummy_query(9)

✨ vmw_cmd_emit_dummy_query(9) ✨

okay so bestie, welcome to vmw_cmd_emit_dummy_query — it's a kernel API function (section 9 of the manual, if you're keeping track, and yes this is the Kernel API Manual 💅). She lives in the vmwgfx driver and honestly? she's the designated driver of query traffic. 🚗💨

---

🌸 SYNOPSIS 🌸

int vmw_cmd_emit_dummy_query (struct vmw_private *dev_priv , uint32_t
cid );

like, look at her signature. iconic. it returns an int and takes a device private struct plus a context id. no notes. 🫶

---

🎀 ARGUMENTS 🎀

• dev_priv — the device private structure 💖. you know the one. it's the device private structure, capital-T The.
• cid — the hardware context id used for the query 🦋. yes, this exact query. that's her id.

---

🌈 DESCRIPTION 🌈

so here's the vibe: this function emits a dummy occlusion query — one with no primitives rendered between query begin and query end 🫥✨. nothing happens in it. that's the whole point. it's a nothing-burger on purpose.

and why would you want a query that does literally nothing?? because it's a query barrier 👑. when this dummy query is finished, you know all preceding queries are also finished. it's giving "wait at the bus stop until everyone's caught up" energy, and honestly? main character behavior. 🚏

⚠️ okay bestie, pre-flight check, do not skip this: a Query results structure should have been initialized at the start of the dev_priv->dummy_query_bo buffer object. and that buffer object must also be either reserved or pinned when this function is called. no cap. if you didn't do this, go do it first 🙈

returns -ENOMEM on failure to reserve fifo space 💀 (that's the one and only failure it reports here — fifo space didn't happen and it's telling you).

---

🦋 SEE ALSO 🦋

• Kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_cmd.c 📁
• vmw_cmd_commit_flush(9)
• vmw_cmd_flush(9)
• vmw_cmd_emit_dummy_legacy_query(9)
• vmw_cmd_emit_dummy_gb_query(9)
• vmw_cmd_supported(9)

like, the whole squad fr fr 🫶

---

and that's the page!! 🌸 this little icon came from the ./drivers/gpu/drm/vmwgfx source tree and the date on her birth certificate says October 2026 — periodt, that's a wrap, ily, read your manpages bestie 💜🎀⭐