STRUCT VENUS_INST(9)

💅 NAME 💅

struct venus_inst — the lil container that holds all the per-instance parameters, bestie. Like, one of these per session, no cap. (Oh and hii, this is the Kernel API Manual — welcome to the group chat ✨)

✨ SYNOPSIS ✨

struct venus_inst {
    struct list_head list;
    struct mutex lock;
    struct venus_core *core;
    struct clock_data clk_data;
    struct list_head dpbbufs;
    struct list_head internalbufs;
    struct list_head registeredbufs;
    struct list_head delayed_process;
    struct work_struct delayed_process_work;
    bool nonblock;
    struct v4l2_ctrl_handler ctrl_handler;
    union {
      struct vdec_controls dec;
      struct venc_controls enc;
    } controls;
    struct v4l2_fh fh;
    unsigned int streamon_cap, streamon_out;
    u32 width;
    u32 height;
    struct v4l2_rect crop;
    u32 fw_min_cnt;
    u32 out_width;
    u32 out_height;
    u32 colorspace;
    u8 ycbcr_enc;
    u8 quantization;
    u8 xfer_func;
    enum venus_dec_state codec_state;
    enum venus_enc_state enc_state;
    wait_queue_head_t reconf_wait;
    unsigned int subscriptions;
    int buf_count;
    struct venus_ts_metadata tss[VIDEO_MAX_FRAME];
    unsigned long payloads[VIDEO_MAX_FRAME];
    u64 fps;
    struct v4l2_fract timeperframe;
    const struct venus_format *fmt_out;
    const struct venus_format *fmt_cap;
    unsigned int num_input_bufs;
    unsigned int num_output_bufs;
    unsigned int input_buf_size;
    unsigned int output_buf_size;
    unsigned int output2_buf_size;
    u32 dpb_buftype;
    u32 dpb_fmt;
    u32 opb_buftype;
    u32 opb_fmt;
    bool reconfig;
    u32 hfi_codec;
    u32 sequence_cap;
    u32 sequence_out;
    struct v4l2_m2m_dev *m2m_dev;
    struct v4l2_m2m_ctx *m2m_ctx;
    struct mutex ctx_q_lock;
    unsigned int state;
    struct completion done;
    unsigned int error;
    bool session_error;
    const struct hfi_inst_ops *ops;
    u32 session_type;
    union hfi_get_property hprop;
    unsigned int core_acquired: 1;
    unsigned int bit_depth;
    unsigned int pic_struct;
    bool next_buf_last;
    bool drain_active;
    enum venus_inst_modes flags;
    struct ida dpb_ids;
 };

🌸 Members 🌸

Okay so now we go field by field, and honestly? There are a LOT of them. Stay with me 🫶

• list — used for attach an instance to the core. Glue duty 💅
• lock — instance lock, the bouncer for this specific instance.
• core — a reference to the core struct.
• clk_data — clock data per core ID.
• dpbbufs — a list of decoded picture buffers.
• internalbufs — a list of internal buffers.
• registeredbufs — a list of registered capture buffers.
• delayed_process — a list of delayed buffers, just vibing in the queue.
• delayed_process_work — a work_struct for process delayed buffers.
• nonblock — nonblocking flag, the "don't wait up for me" switch.
• ctrl_handler — v4l control handler.
• controls — a union of decoder and encoder control parameters. One of these at a time, pick a lane ✨
• fh — a holder of v4l file handle structure.
• streamon_cap — stream on flag for capture queue.
• streamon_out — stream on flag for output queue.
• width — current capture width.
• height — current capture height.
• crop — current crop rectangle.
• fw_min_cnt — firmware minimum buffer count.
• out_width — current output width.
• out_height — current output height.
• colorspace — current color space.
• ycbcr_enc — current YCbCr encoding.
• quantization — current quantization.
• xfer_func — current xfer function.
• codec_state — current decoder API state (see DEC_STATE_).
• enc_state — current encoder API state (see ENC_STATE_).
• reconf_wait — wait queue for resolution change event. She waits 🥺
• subscriptions — used to hold current events subscriptions.
• buf_count — used to count number of buffers (reqbuf(0)).
• tss — timestamp metadata.
• payloads — cache plane payload to use it for clock/BW scaling.
• fps — holds current FPS.
• timeperframe — holds current time per frame structure.
• fmt_out — a reference to output format structure.
• fmt_cap — a reference to capture format structure.
• num_input_bufs — holds number of input buffers.
• num_output_bufs — holds number of output buffers.
• input_buf_size — holds input buffer size.
• output_buf_size — holds output buffer size.
• output2_buf_size — holds secondary decoder output buffer size.
• dpb_buftype — decoded picture buffer type.
• dpb_fmt — decoded picture buffer raw format.
• opb_buftype — output picture buffer type.
• opb_fmt — output picture buffer raw format.
• reconfig — a flag raised by decoder when the stream resolution changed.
• hfi_codec — current codec for this instance in HFI space.
• sequence_cap — a sequence counter for capture queue.
• sequence_out — a sequence counter for output queue.
• m2m_dev — a reference to m2m device structure.
• m2m_ctx — a reference to m2m context structure.
• ctx_q_lock — a lock to serialize video device ioctl calls.
• state — current state of the instance.
• done — a completion for sync HFI operation.
• error — an error returned during last HFI sync operation.
• session_error — a flag rised by HFI interface in case of session error.
• ops — HFI operations.
• session_type — the type of the session (decoder or encoder).
• hprop — a union used as a holder by get property.
• core_acquired — the Core has been acquired. She's taken 🔒
• bit_depth — current bitstream bit-depth.
• pic_struct — bitstream progressive vs interlaced.
• next_buf_last — a flag to mark next queued capture buffer as last.
• drain_active — Drain sequence is in progress.
• flags — bitmask flags describing current instance mode.
• dpb_ids — DPB buffer ID's.

🔥 SEE ALSO 🔥

• Kernel file ./drivers/media/platform/qcom/venus/core.h struct
• venus_core(9)

And that's the whole page, bestie, you ate that 💖 This icon lives at ./drivers/media/platform/qcom/... in the October 2026 edition of struct venus_inst(9) — go forth and read the struct, periodt 🎀🌸