STRUCT HVA_FRAME(9)

💅 struct hva_frame(9)

okay bestie, welcome to the struct hva_frame(9) page from the Kernel API Manual — yes it's a kernel API page, yes it's giving driver-internals realness, and yes we're gonna get through it together 🫶

---

✨ NAME ✨

struct hva_frame — the hva frame buffer (output) 🌸

like literally that's the whole vibe: it's the frame buffer struct, and it's on the output side of things, iykyk.

---

🦋 SYNOPSIS 🦋

struct hva_frame {
    struct vb2_v4l2_buffer  vbuf;
    struct list_head        list;
    struct hva_frameinfo    info;
    dma_addr_t paddr;
    void *vaddr;
    bool prepared;
 };

no cap, that's the whole struct, character for character 💖

---

🎀 Members 🎀

• vbuf — the video buffer information for V4L2, the classic video-buffer situation 👑
• list — the V4L2 m2m list that the frame belongs to, so it knows which friend group it's in 🫶
• info — frame information (width, height, format, alignment...), literally all the frame's stats ✨
• paddr — the physical address (for hardware), the hardware's lil home address 🏠
• vaddr — the virtual address (kernel can read/write), so the kernel can just. read and write. iconic 💅
• prepared — true if vaddr/paddr are resolved, aka the glow-up is complete ⭐

---

🌈 SEE ALSO 🌈

this is the part where we shout out the whole squad, no one left behind 💜

• Kernel file ./drivers/media/platform/st/sti/hva/hva.h struct
• hva_frameinfo(9)
• struct hva_streaminfo(9)
• struct hva_controls(9)
• struct hva_stream(9)
• struct hva_ctx_dbg(9)
• struct hva_ctx(9)
• struct hva_dev_dbg(9)
• struct hva_dev(9)
• struct hva_enc(9)

like that is a full roster fr fr 🌸

---

lowkey a reminder that this page lives at ./drivers/media/platform/st/st... — that's the truncated path exactly as it shows up in the footer, so don't come for me 🥲

and that's the page!! mwah 💋 this one's from October 2026, straight out of the kernel API manual, struct hva_frame(9) era — periodt, slay, go read the other hva structs 🧚‍♀️🔥