vmw_stdu_pr...e_prepare_fb(9)

💅 vmw_stdu_primary_plane_prepare_fb — the NAME bit ✨

okay so bestie, this is vmw_stdu_primary_plane_prepare_fb and it comes to you straight from the Kernel API Manual (yes, the whole manual, we're fancy like that 🎀). Short version? It readies the display surface. That's the vibe. That's the whole job. 🔥

---

✨ SYNOPSIS ✨

int vmw_stdu_primary_plane_prepare_fb (struct drm_plane *plane , struct
       drm_plane_state *new_state );

like, literally copy that exactly, don't @ me 💅

---

🫶 ARGUMENTS 🫶

• plane — the display plane itself, the main character of this whole situation 👑
• new_state — all the info about the new plane state, and yes that includes the FB, it's giving "the FB is in there, iykyk" 💖

---

🌸 DESCRIPTION 🌸

okay so here's the tea 🍓 — this function allocates a new display surface if the content is backed by a buffer object. That's the whole bit.

The display surface gets pinned right here in this function, and then it'll get unpinned later in .cleanup_fb. so like, the pinning and the unpinning are a matched set, don't forget the cleanup part fr fr 🧚

---

⭐ RETURN ⭐

0 on success ✨ that's it, that's the number, we love a clean zero 🫶

---

🦋 SEE ALSO 🦋

the whole friend group, no cap:

• Kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_stdu.c — that's where this lives, go look 👀
• 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_kms_stdu_surface_dirty(9)
• vmw_stdu_encoder_destroy(9)
• vmw_stdu_connector_destroy(9)
• vmw_stdu_primary_plane_cleanup_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)

like I said — the whole friend group 😭💜

---

ngl if you're reading this at 3am in ./drivers/gpu/drm/vmwgfx, drink some water bestie, the kernel will still be there in the morning 🫶

---

and that's the page!! 🌈 sign-off time: this lil beauty ships from ./drivers/gpu/drm/vmwgfx and it's dated October 2026 — so yeah, it's from the future, we stay iconic 👑✨ periodt 💅