get_wave_count(9)

💅 get_wave_count(9) — like, the kernel API manual, bestie

okay so bestie, welcome to get_wave_count, straight out of the Kernel API Manual ✨ this one is a function, it lives in the kernel, and it's about reading device registers to figure out how many waves are in flight for one particular queue 🌀 and like, as a lil bonus, it also hands you back the VMID that's associated with that queue. two-for-one, we love to see it 💖

✨ NAME ✨

get_wave_count — reads the device registers so you can get the number of waves in flight for a particular queue 🎀 and the method also returns the VMID associated with the queue, no cap 🫶

✨ SYNOPSIS ✨

void get_wave_count (struct amdgpu_device *adev , int queue_idx , struct
kfd_cu_occupancy *queue_cnt , uint32_t inst );

that's it, that's the whole signature 💅 she takes four things and returns void, periodt.

✨ ARGUMENTS ✨

• adev — the handle of the device whose registers are gonna get read 👑 like, this is the GPU we're snooping on.
• queue_idx — the index of the queue in the queue-map bit-field 🌸 so, which queue are we talking about, bestie.
• queue_cnt — this one stores the wave count and the doorbell offset for an active queue 🦋 tiny little struct doing two jobs, iconic.
• inst — the xcc's instance number on a multi-XCC setup ⭐ like, if you've got more than one XCC, this tells her which one you mean. iykyk.

ngl, all four of these are required — there's no optional vibe here, every single one is doing its job 🙈

✨ SEE ALSO ✨

• Kernel file ./drivers/gpu/drm/amd/amdgpu/amdgpu_amdkfd_gfx_v9.c 📁
• kgd_gfx_v9_get_cu_occupancy(9) — go read that one too, fr fr 🔥

and that's the whole page, bestie 🎀 this came to you from ./drivers/gpu/drm/amd/amdgpu, dated October 2026, and yes the page name is get_wave_count(9) — mwah, slay, bye 💋✨