vmw_hw_surface_destroy(9)

✨ vmw_hw_surface_destroy(9) ✨

okay so bestie, welcome to the Kernel API Manual entry for vmw_hw_surface_destroy — it's a little DRM/vmwgfx cleanup function and honestly it's giving "designated driver at the end of the party" energy 🎀

---

🦋 NAME 🦋

vmw_hw_surface_destroy — destroy a Device surface 💅

---

🌸 SYNOPSIS 🌸

void vmw_hw_surface_destroy (struct vmw_resource *res );

that's it, that's the whole signature, no cap ✨

---

💖 ARGUMENTS 💖

• res — pointer to a struct vmw_resource that is embedded in a struct vmw_surface. yes, embedded, like it lives inside it, main character nested-struct situation 🫶

---

🔥 DESCRIPTION 🔥

So what it does: it destroys the device surface associated with a struct vmw_surface — if there is one (no surface? nothing happens, it's chill 🙈) — and then it adjusts the resource count accordingly. That's the whole vibe check. Clean up the device surface, fix up the count, done. periodt 💀✨

ngl this is one of those "don't skip the bookkeeping" functions — the resource count adjustment is literally part of the job, not a bonus feature 👑

---

🌈 SEE ALSO 🌈

bestie the cross-reference list here is iconic, it's huge, we love an interconnected subsystem 🧚💜

• Kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_surface.c
• struct vmw_user_surface(9)
• struct vmw_surface_offset(9)
• struct vmw_surface_dirty(9)
• vmw_surface_dma_size(9)
• vmw_surface_define_size(9)
• vmw_surface_destroy_size(9)
• vmw_surface_destroy_encode(9)
• vmw_surface_define_encode(9)
• vmw_surface_dma_encode(9)
• vmw_legacy_srf_create(9)
• vmw_legacy_srf_dma(9)
• vmw_legacy_srf_bind(9)
• vmw_legacy_srf_unbind(9)
• vmw_legacy_srf_destroy(9)
• vmw_surface_init(9)
• vmw_user_surface_base_to_res(9)
• vmw_user_surface_free(9)
• vmw_user_surface_base_release(9)
• vmw_surface_destroy_ioctl(9)
• vmw_surface_define_ioctl(9)
• vmw_surface_reference_ioctl(9)
• vmw_gb_surface_create(9)
• vmw_gb_surface_define_ioctl(9)
• vmw_gb_surface_reference_ioctl(9)
• vmw_gb_surface_define_ext_ioctl(9)
• vmw_gb_surface_reference_ext_ioctl(9)
• vmw_gb_surface_define_internal(9)
• vmw_gb_surface_reference_internal(9)
• vmw_subres_dirty_add(9)
• vmw_subres_dirty_full(9)
• vmw_dumb_create(9)

like, go read them, iykyk 📚💫

---

and that's the page!! mwah 💋 this lil doc lives under ./drivers/gpu/drm/vmwgfx, dated October 2026, and it's page vmw_hw_surface_destroy(9) of the Kernel API Manual — go forth and destroy those surfaces responsibly, bestie 🌟🎀🫶