STRUCT MTK_VCODEC_DEC_CTX(9)

💅 struct mtk_vcodec_dec_ctx(9) ✨

okay bestie, welcome to the Kernel API Manual page for struct mtk_vcodec_dec_ctx 🎀 — this is the glow-up doc for the MediaTek vcodec decoder context struct, and we're gonna get through it together, no cap.

🌸 NAME 🌸

struct mtk_vcodec_dec_ctx — Context (instance) private data. that's it, that's the vibe 💖

✨ SYNOPSIS ✨

here's the whole struct, laid out exactly as it lives, do not touch, just admire 👑

struct mtk_vcodec_dec_ctx {
    enum mtk_instance_type type;
    struct mtk_vcodec_dec_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;
    const struct vdec_common_if *dec_if;
    void *drv_handle;
    struct vdec_pic_info picinfo;
    int dpb_size;
    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 decode_work;
    struct vdec_pic_info last_decoded_picinfo;
    struct v4l2_m2m_buffer empty_flush_buf;
    bool is_flushing;
    u32 current_codec;
    u32 capture_fourcc;
    enum v4l2_colorspace colorspace;
    enum v4l2_ycbcr_encoding ycbcr_enc;
    enum v4l2_quantization quantization;
    enum v4l2_xfer_func xfer_func;
    int decoded_frame_cnt;
    struct mutex lock;
    int hw_id;
    struct vdec_msg_queue msg_queue;
    void *vpu_inst;
    bool is_10bit_bitstream;
 };

🦋 Members 🦋

okay now the main character energy part — every single field, explained 🫶

• type — the type of decoder instance 💫
• dev — pointer to the mtk_vcodec_dec_dev of the device. like, which device this baby belongs to.
• list — link to ctx_list of mtk_vcodec_dec_dev 🔗
• fh — a struct v4l2_fh. that's the whole description, she's mysterious like that 🙈
• m2m_ctx — pointer to the v4l2_m2m_ctx of the context
• q_data — store information of input and output queue of the context. note the [2], two queues, iconic.
• id — index of the context that this structure describes 🔢
• state — state of the context
• dec_if — hooked decoder driver interface ⚓
• drv_handle — driver handle for specific decode/encode instance
• picinfo — store picture info after header parsing 🖼️
• dpb_size — store dpb count after header parsing
• int_cond — variable used by the waitqueue
• int_type — type of the last interrupt ⚡
• queue — waitqueue that can be used to wait for this context to finish. there's MTK_VDEC_HW_MAX of them, one per hardware bestie 💜
• irq_status — irq status
• ctrl_hdl — handler for v4l2 framework
• decode_work — worker for the decoding. get it, work_struct, doing the WORK 💪
• last_decoded_picinfo — pic information get from latest decode
• empty_flush_buf — a fake size-0 capture buffer that indicates flush. Used for stateful decoder. she's fake but she's important 💅
• is_flushing — set to true if flushing is in progress.
• current_codec — current set input codec, in V4L2 pixel format
• capture_fourcc — capture queue type in V4L2 pixel format
• 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
• decoded_frame_cnt — number of decoded frames 🎬
• lock — protect variables accessed by V4L2 threads and worker thread such as mtk_video_dec_buf. respect the lock, fr fr 🔒
• hw_id — hardware index used to identify different hardware.
• msg_queue — msg queue used to store lat buffer information.
• vpu_inst — vpu instance pointer.
• is_10bit_bitstream — set to true if it's 10bit bitstream ⭐

🔥 SEE ALSO 🔥

• Kernel file ./drivers/media/platform/mediatek/vcodec/decoder/mtk_vcodec_dec_drv.h 📁
• struct vdec_pic_info(9), struct mtk_vcodec_dec_pdata(9), struct mtk_vcodec_dec_request(9), struct mtk_vcodec_dec_dev(9) — go read these next bestie, they're all linked up 🧚

that's the whole page, you ate it up 💅✨ this little gem came from ./drivers/media/platform/media... and it's dated October 2026, so mark your calendars and go forth and decode 🎀💖