vmw_kms_stdu_surface_dirty(9)

✨ vmw_kms_stdu_surface_dirty(9) — from the Kernel API Manual, bestie ✨

okay so hi bestie 💖 welcome to the Kernel API Manual entry for vmw_kms_stdu_surface_dirty(9). This is the group-chat recap: she dirties part of a surface backed framebuffer, and the whole function signature is right below. No cap, every argument matters.

💖 NAME 💖

vmw_kms_stdu_surface_dirty — dirty part of a surface backed framebuffer. Literally the whole plot. 🎬

🌸 SYNOPSIS 🌸

int vmw_kms_stdu_surface_dirty (struct vmw_private *dev_priv , struct
vmw_framebuffer *framebuffer , struct drm_clip_rect *clips , struct
drm_vmw_rect *vclips , struct vmw_resource *srf , s32 dest_x , s32
dest_y , unsigned num_clips , int inc , struct vmw_fence_obj **out_fence
, struct drm_crtc *crtc );

🎀 ARGUMENTS 🎀

• dev_priv — pointer to the device private structure. iykyk
• framebuffer — pointer to the surface-buffer backed framebuffer. 🖼️
• clips — array of clip rects. 🚨 either clips or vclips must be NULL — bestie, this is not a both-at-once situation.
• vclips — alternate array of clip rects. 🚨 either clips or vclips must be NULL. same rule, different array, periodt.
• srf — pointer to surface to blit from. If NULL, the surface attached to framebuffer will be used. easy swap energy
• dest_x — X coordinate offset to align srf with framebuffer coordinates. 📍
• dest_y — Y coordinate offset to align srf with framebuffer coordinates. 📍
• num_clips — number of clip rects in clips. 🔢
• inc — increment to use when looping over clips. 🔁
• out_fence — if non-NULL, will return a ref-counted pointer to a struct vmw_fence_obj. The returned fence pointer may be NULL, in which case the device has already synchronized. fence lore
• crtc — if crtc is passed, perform surface dirty on that crtc only. 🎯

🌈 RETURN 🌈

0 on success, negative error code on failure. -ERESTARTSYS if interrupted. periodt.

🦋 SEE ALSO 🦋

Bestie, the kernel file is ./drivers/gpu/drm/vmwgfx/vmwgfx_stdu.c, and these are the references — all of them, no skipping, because we don’t do that here:

• struct vmw_stdu_dirty(9)
• struct vmw_screen_target_display_unit(9)
• vmw_stdu_crtc_destroy(9)
• vmw_stdu_define_st(9)
• vmw_stdu_bind_st(9)
• vmw_stdu_populate_update(9)
• vmw_stdu_update_st(9)
• vmw_stdu_destroy_st(9)
• vmw_stdu_crtc_mode_set_nofb(9)
• vmw_stdu_bo_cpu_clip(9)
• vmw_stdu_bo_cpu_commit(9)
• vmw_kms_stdu_readback(9)
• vmw_kms_stdu_surface_clip(9)
• vmw_kms_stdu_surface_fifo_commit(9)
• vmw_stdu_encoder_destroy(9)
• vmw_stdu_connector_destroy(9)
• vmw_stdu_primary_plane_cleanup_fb(9)
• vmw_stdu_primary_plane_prepare_fb(9)
• vmw_stdu_plane_update_bo(9)
• vmw_stdu_plane_update_surface(9)
• vmw_stdu_primary_plane_atomic_update(9)
• vmw_stdu_init(9)
• vmw_stdu_destroy(9)
• vmw_kms_stdu_init_display(9)

mwah 💋 — this page is from the Kernel API Manual, source/version ./drivers/gpu/drm/vmwgfx, dated October 2026, and it’s literally vmw_kms_stdu_surface_dirty(9), periodt. 💖✨🎀