STRUCT AMVDEC_SESSION(9)

🎀 struct amvdec_session(9) — Kernel API Manual 💅

okay bestie, so this is a page from the Kernel API Manual and it's literally all about struct amvdec_session — the struct that holds all your decoding session parameters. no cap, it's giving "one struct to rule them all" energy 👑

✨ NAME ✨

struct amvdec_session — decoding session parameters 🦋

🌸 SYNOPSIS 🌸

struct amvdec_session {
    struct amvdec_core *core;
    struct v4l2_fh fh;
    struct v4l2_m2m_dev *m2m_dev;
    struct v4l2_m2m_ctx *m2m_ctx;
    struct v4l2_ctrl_handler ctrl_handler;
    struct v4l2_ctrl *ctrl_min_buf_capture;
    struct mutex lock;
    const struct amvdec_format *fmt_out;
    u32 pixfmt_cap;
    u32 src_buffer_size;
    u32 width;
    u32 height;
    u32 colorspace;
    u8 ycbcr_enc;
    u8 quantization;
    u8 xfer_func;
    struct v4l2_fract pixelaspect;
    atomic_t esparser_queued_bufs;
    struct work_struct esparser_queue_work;
    unsigned int streamon_cap, streamon_out;
    unsigned int sequence_cap, sequence_out;
    unsigned int should_stop;
    unsigned int keyframe_found;
    unsigned int num_dst_bufs;
    unsigned int changed_format;
    u8 canvas_alloc[MAX_CANVAS];
    u32 canvas_num;
    void *vififo_vaddr;
    dma_addr_t vififo_paddr;
    u32 vififo_size;
    struct list_head bufs_recycle;
    struct mutex bufs_recycle_lock;
    struct task_struct *recycle_thread;
    struct list_head timestamps;
    spinlock_t ts_spinlock;
    u64 last_irq_jiffies;
    u32 last_offset;
    u32 wrap_count;
    u32 fw_idx_to_vb2_idx[32];
    enum amvdec_status status;
    void *priv;
};

💖 Members 💖

bestie there are SO many fields, grab a snack 🍓 — let's go through every single one, no skips:

• core — a reference to the vdec core struct 👑
• fh — the v4l2 file handle
• m2m_dev — the v4l2 m2m device
• m2m_ctx — the v4l2 m2m context
• ctrl_handler — the V4L2 control handler
• ctrl_min_buf_capture — V4L2 control V4L2_CID_MIN_BUFFERS_FOR_CAPTURE
• lock — cap & out queues lock 🔒
• fmt_out — vdec pixel format for the OUTPUT queue
• pixfmt_cap — V4L2 pixel format for the CAPTURE queue
• src_buffer_size — size in bytes of the OUTPUT buffers' only plane
• width — current picture width
• height — current picture height
• colorspace — current colorspace 🌈
• ycbcr_enc — current ycbcr_enc
• quantization — current quantization
• xfer_func — current transfer function
• pixelaspect — Pixel Aspect Ratio reported by the decoder
• esparser_queued_bufs — number of buffers currently queued into ESPARSER
• esparser_queue_work — work struct for the ESPARSER to process src buffers
• streamon_cap — stream on flag for capture queue
• streamon_out — stream on flag for output queue
• sequence_cap — capture sequence counter 🔢
• sequence_out — output sequence counter 🔢
• should_stop — flag set if userspace signaled EOS via command or empty buffer 🛑
• keyframe_found — flag set once a keyframe has been parsed 🔑
• num_dst_bufs — number of destination buffers
• changed_format — the format changed (iconic behavior honestly)
• canvas_alloc — array of all the canvas IDs allocated 🎨
• canvas_num — number of canvas IDs allocated
• vififo_vaddr — virtual address for the VIFIFO
• vififo_paddr — physical address for the VIFIFO
• vififo_size — size of the VIFIFO dma alloc
• bufs_recycle — list of buffers that need to be recycled ♻️
• bufs_recycle_lock — lock for the bufs_recycle list 🔒
• recycle_thread — task struct for the recycling thread
• timestamps — chronological list of src timestamps ⏰
• ts_spinlock — spinlock for the timestamps list
• last_irq_jiffies — tracks last time the vdec triggered an IRQ ⚡
• last_offset — tracks last offset of vififo
• wrap_count — number of times the vififo wrapped around 🌀
• fw_idx_to_vb2_idx — firmware buffer index to vb2 buffer index
• status — current decoding status
• priv — codec private data 🙈

🦋 SEE ALSO 🦋

Kernel file ./drivers/staging/media/meson/vdec/vdec.h struct amvdec_timestamp(9), struct amvdec_core(9), struct amvdec_ops(9), struct amvdec_codec_ops(9), struct amvdec_format(9)

and that's the whole vibe check bestie 💜 this little icon came from ./drivers/staging/media/meson/..., October 2026, and the page itself is struct amvdec_session(9) — go slay your decoding session fr fr 💅✨🎀