vmw_surface_setup_cache(9)

💅 vmw_surface_setup_cache(9) 💅

okay so bestie, this one's from the Kernel API Manual, and it is literally about building a surface cache entry. no cap, that's the whole vibe. 🫶

✨ NAME ✨

vmw_surface_setup_cache — Build a surface cache entry

🌈 SYNOPSIS 🌈

int vmw_surface_setup_cache (const struct drm_vmw_size *size ,
       SVGA3dSurfaceFormat format , u32 num_mip_levels , u32 num_layers , u32
       num_samples , struct vmw_surface_cache *cache );

🎀 ARGUMENTS 🎀

• size — the surface base level dimensions. iconic.
• format — the surface format. slay.
• num_mip_levels — number of mipmap levels.
• num_layers — number of layers.
• num_samples — okay so the source literally says -- undescribed -- and i'm not gonna invent lore 💀
• cache — pointer to a struct vmw_surface_cach object to be filled in. (yes, cach — that's exactly what the original says, don't come for me 🙈)

💖 RETURN 💖

Zero on success, -EINVAL on invalid surface layout. that's the tea. ✨

🦋 SEE ALSO 🦋

• Kernel file: ./drivers/gpu/drm/vmwgfx/vmw_surface_cache.h
• 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_subres(9)
• vmw_surface_get_loc(9)
• vmw_surface_inc_loc(9)
• vmw_surface_min_loc(9)

mwah 💋 that's the whole page, bestie — source/version ./drivers/gpu/drm/vmwgfx, dated October 2026. periodt. 🎀