vmw_surface_subres(9)

💅 vmw_surface_subres(9) — a Kernel API Manual moment

okay so bestie, welcome to vmw_surface_subres(9), like the actual kernel API manual page, and no cap this one is short and sweet. sit down, grab a strawberry 🍓, we're doing graphics driver math together.

---

✨ NAME ✨

vmw_surface_subres — literally just computes the subresource from the layer and the mipmap. that's it. that's the whole job. 💖

---

🎀 SYNOPSIS 🎀

u32 vmw_surface_subres (const struct vmw_surface_cache *cache , u32
mip_level , u32 layer );

it gives you back a u32, the subresource. iconic. ✨

---

🌸 ARGUMENTS 🌸

• cache — the surface layout data. this is the glow-up info about how the surface is laid out, and you're passing it in const because we look, we don't touch. 🙈
• mip_level — the mipmap level. yes, u32, yes, like the tiny versions of the texture. the mipmap level, bestie. 💅
• layer — the surface layer. and before you ask, that's the face or the array slice. iykyk. 🦋

---

⭐ RETURN ⭐

the subresource. that's the whole return value. short king. 👑

---

🌈 SEE ALSO 🌈

okay this section is a whole friend group, fr fr, so let's go:

• the kernel file ./drivers/gpu/drm/vmwgfx/vmw_surface_cache.h — go read it, it's giving source of truth 📖
• vmw_surface_get_desc(9)
• vmw_surface_get_mip_size(9)
• vmw_surface_get_image_buffer_size(9)
• vmw_surface_get_serialized_size(9)
• vmw_surface_get_serialized_size_extended(9)
• vmw_surface_get_pixel_offset(9)
• vmw_surface_is_gb_screen_target_format(9)
• vmw_surface_is_dx_screen_target_format(9)
• vmw_surface_is_screen_target_format(9)
• struct vmw_surface_mip(9)
• struct vmw_surface_cache(9)
• struct vmw_surface_loc(9)
• vmw_surface_setup_cache(9)
• vmw_surface_get_loc(9)
• vmw_surface_inc_loc(9)
• vmw_surface_min_loc(9)

like, the whole vmw_surface_cache.h cinematic universe. obsessed. 🔥

---

heads up bestie: every one of those cross-references is a real page you can go read, so don't just take my word for it. 🫶

---

and that's the tea 🧚 this came out of ./drivers/gpu/drm/vmwgfx, dated October 2026, and it's the vmw_surface_subres(9) page. slay, go compute some subresources, mwah 💜🎀