vmw_legacy_srf_create(9)

💅 vmw_legacy_srf_create(9) ✨

okay so welcome to the Kernel API Manual, bestie — today’s main character is vmw_legacy_srf_create(9), and yes she ate. 🫶

💖 NAME 💖

vmw_legacy_srf_create — creates a device surface as part of the resource validation process. slay. 👑

🌸 SYNOPSIS 🌸

int vmw_legacy_srf_create (struct vmw_resource *res );

🎀 ARGUMENTS 🎀

• res — pointer to a struct vmw_surface. 🫶

🦋 DESCRIPTION 🦋

okay so this is the move for when the surface doesn't have a hw id. ✨

It returns -EBUSY if there wasn't sufficient device resources to complete the validation. Retry after freeing up resources. 💀

May return other errors if the kernel is out of guest resources. no cap. 😭

🌈 SEE ALSO 🌈

go read these, bestie — the whole squad is here:

• 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_hw_surface_destroy(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)

xoxo 💖 from ./drivers/gpu/drm/vmwgfx, October 2026 — vmw_legacy_srf_create(9) signing off ✨