STRUCT MTK_VCODEC_ENC_CTX(9)

🌸 struct mtk_vcodec_enc_ctx(9) 🌸

okay so bestie, welcome to the Kernel API Manual 💖 this page is all about struct mtk_vcodec_enc_ctx — literally the private data for one context (a whole instance, like a whole little world 🌍). yes it's a C struct, yes it's iconic, no you can't skip it.

---

✨ NAME ✨

struct mtk_vcodec_enc_ctx — the context (instance) private data. that's it, that's the vibe 💅 it's the per-instance bag of holding for MediaTek's encoder.

---

🎀 SYNOPSIS 🎀

here's the whole thing, character for character, do not touch, she's perfect:

struct mtk_vcodec_enc_ctx {
    enum mtk_instance_type type;
    struct mtk_vcodec_enc_dev *dev;
    struct list_head list;
    struct v4l2_fh fh;
    struct v4l2_m2m_ctx *m2m_ctx;
    struct mtk_q_data q_data[2];
    int id;
    enum mtk_instance_state state;
    enum mtk_encode_param param_change;
    struct mtk_enc_params enc_params;
    const struct venc_common_if *enc_if;
    void *drv_handle;
    int int_cond[MTK_VDEC_HW_MAX];
    int int_type[MTK_VDEC_HW_MAX];
    wait_queue_head_t queue[MTK_VDEC_HW_MAX];
    unsigned int irq_status;
    struct v4l2_ctrl_handler ctrl_hdl;
    struct work_struct encode_work;
    struct v4l2_m2m_buffer empty_flush_buf;
    bool is_flushing;
    enum v4l2_colorspace colorspace;
    enum v4l2_ycbcr_encoding ycbcr_enc;
    enum v4l2_quantization quantization;
    enum v4l2_xfer_func xfer_func;
    struct mutex q_mutex;
    void *vpu_inst;
};

---

💜 Members 💜

🦋 the basics

• type — what kind of encoder instance this is. the personality type of the instance, if you will ✨
• dev — pointer to the mtk_vcodec_enc_dev of the device. the parent, the home base, the main character 🏠
• list — link to ctx_list of mtk_vcodec_enc_dev. it's how this ctx hangs out with all the other ctxs 🫶
• fh — a struct v4l2_fh. just… there. slaying quietly 💅
• m2m_ctx — pointer to the v4l2_m2m_ctx of the context. mem2mem brain.
• q_data — store information of input and output queue of the context. two of them ([2]), because input AND output, duh 👑
• id — index of the context that this structure describes. her little name tag 🏷️
• state — state of the context. mood ring, basically 🔮

🌈 the encoding stuff

• param_change — indicate encode parameter type. flags which kind of encode params changed, no cap.
• enc_params — encoding parameters. the actual seasoning in the soup 🍓
• enc_if — hooked encoder driver interface. the plug, the connector, the const struct venc_common_if * girly.
• drv_handle — driver handle for specific decode/encode instance. yes the manpage literally says "decode/encode" — we do not edit ✍️

🔥 interrupts & waiting

• int_cond — variable used by the waitqueue.
• int_type — type of the last interrupt. she remembers the last interrupts, both arrays are [MTK_VDEC_HW_MAX] sized btw ⭐
• queue — waitqueue that can be used to wait for this context to finish. also [MTK_VDEC_HW_MAX], also iconic.
• irq_status — irq status. that's the whole description, she's mysterious like that 🙈

🎀 v4l2 framework corner

• ctrl_hdl — handler for v4l2 framework. the control freak (affectionate) 💖
• encode_work — worker for the encoding. she works, she's a struct work_struct, we respect her 🫡
• empty_flush_buf — a fake size-0 capture buffer that indicates flush. Used for encoder. it's fake but it's doing her best 😭 honestly a legend for that.
• is_flushing — set to true if flushing is in progress. true girlies set it, false girlies… also possible 🚽✨

💀 colorspace lore (do NOT skip, I know you want to)

• colorspace — enum v4l2_colorspace; supplemental to pixelformat.
• ycbcr_enc — enum v4l2_ycbcr_encoding, Y'CbCr encoding.
• quantization — enum v4l2_quantization, colorspace quantization.
• xfer_func — enum v4l2_xfer_func, colorspace transfer function.

like yes it's four whole enum fields but they're besties and they come as a set 💜

🌸 the last two

• q_mutex — vb2_queue mutex. lock her before you touch her, mutual respect 🔒
• vpu_inst — vpu instance pointer. final member energy, main character exit 👑

---

⭐ SEE ALSO ⭐

go read these next, bestie, iykyk:

• Kernel file ./drivers/media/platform/mediatek/vcodec/encoder/mtk_vcodec_enc_drv.h
• struct mtk_vcodec_enc_pdata(9)
• struct mtk_enc_params(9)
• struct mtk_vcodec_enc_dev(9)

---

also, just so we're clear: the manpage footer literally shows the source as ./drivers/media/platform/media... — truncated and everything, that's the actual original text, we are NOT fixing it 🫶

okay that's the page!! this was struct mtk_vcodec_enc_ctx(9), from the Kernel API Manual, the source/version line being ./drivers/media/platform/media... and the date October 2026 (futuristic icon behavior, honestly 🔥). mwah, go encode something, bestie 💋💖✨