intel_prepare_plane_fb(9)

okay bestie, welcome to the intel_prepare_plane_fb(9) page from the Kernel API Manual ✨ this one is all about getting a framebuffer ready for a display plane, and honestly it's giving “quietly important” 💅

💖 NAME 💖

intel_prepare_plane_fb — prepare an fb for usage on a plane 🎀

🌸 SYNOPSIS 🌸

int intel_prepare_plane_fb (struct drm_plane *_plane , struct
       drm_plane_state *_new_plane_state );

🎀 ARGUMENTS 🎀

• _plane — the drm plane you're preparing for, bestie. main character energy fr fr.
• _new_plane_state — the plane state being prepared. okay so this is the state in question 🦋

🦋 DESCRIPTION 🦋

so what's the vibe? It prepares a framebuffer for usage on a display plane. Generally this involves pinning the underlying object and updating the frontbuffer tracking bits. Some older platforms need special physical address handling for cursor planes — yes, the elders have needs 🫶

and the return situation: it returns 0 on success, and a negative error code on failure. no cap 💀

💅 SEE ALSO 💅

Kernel file ./drivers/gpu/drm/i915/display/intel_plane.c is the source spot 👑 and you should also peek at atomic plane helpers(9), intel_plane_destroy(9), intel_plane_duplicate_state(9), intel_plane_destroy_state(9), and intel_cleanup_plane_fb(9). iykyk 🌈

mwah 💋 — this lil' page lives under ./drivers/gpu/drm/i915/display, dated October 2026, and it's serving intel_prepare_plane_fb(9) from the Kernel API Manual. periodt 🎀