STRUCT VMW_SURFACE_CACHE(9)

🎀 struct vmw_surface_cache(9) 🎀

okay so this is a page from the Kernel API Manual bestie, and it's all about struct vmw_surface_cache — literally the place where cached surface info lives. no cap, that's the whole vibe.

---

✨ NAME ✨

struct vmw_surface_cache — Cached surface information 💅

---

🌸 SYNOPSIS 🌸

ok so here's the struct, exactly as it is, don't come for me:

struct vmw_surface_cache {
    const SVGA3dSurfaceDesc *desc;
    struct vmw_surface_mip mip[DRM_VMW_MAX_MIP_LEVELS];
    size_t mip_chain_bytes;
    size_t sheet_bytes;
    u32 num_mip_levels;
    u32 num_layers;
 };

---

🦋 Members 🦋

bestie, let's go field by field, i got you:

• desc — Pointer to the surface descriptor. iconic little reference, we love her 💖
• mip — Array of mipmap level information. Valid size is num_mip_levels. so like, only the first num_mip_levels entries are actually the real ones, periodt.
• mip_chain_bytes — Bytes required in the backing store for the whole chain of mip levels. the entire chain, all of it, no crumbs left 🍓
• sheet_bytes — Bytes required in the backing store for a sheet representing a single sample. just one sample, one sheet, that's the assignment ✨
• num_mip_levels — Valid size of the mip array. Number of mipmap levels in a chain. this is the number that tells you how much of that array is actually valid, iykyk 🙈
• num_layers — Number of slices in an array texture or number of faces in a cubemap texture. slices OR faces depending on the texture situation, both valid, we don't gatekeep 💜

---

🔥 SEE ALSO 🔥

if you're obsessed with this one (and you should be tbh), go read the Kernel file here:

• ./drivers/gpu/drm/vmwgfx/vmw_surface_cache.h

and the whole friend group of related pages, all of them, not skipping a single one:

• 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_loc(9)
• vmw_surface_subres(9)
• vmw_surface_setup_cache(9)
• vmw_surface_get_loc(9)
• vmw_surface_inc_loc(9)
• vmw_surface_min_loc(9)

---

ngl that's a whole lot of related pages, but they're all lowkey serving. go read them, your future self will thank you 🫶

---

alright bestie, that's the whole page!! this one came from the source dir ./drivers/gpu/drm/vmwgfx and it's dated October 2026 — like, future vibes much? 🌈⭐ anyway, struct vmw_surface_cache(9) out, mwah 💅💖🧚