v4l2_ctrl_request_hdl_find(9)

🎀 NAME 🎀

okay bestie, welcome to the v4l2_ctrl_request_hdl_find(9) page from the Kernel API Manual — and the name is literally doing the most: v4l2_ctrl_request_hdl_find means Find the control handler in the request. no cap. 💅

---

✨ SYNOPSIS ✨

struct v4l2_ctrl_handler * v4l2_ctrl_request_hdl_find (struct
       media_request *req , struct v4l2_ctrl_handler *parent );

---

🌸 ARGUMENTS 🌸

• req — the request. that's the whole vibe. 💖
• parent — the parent control handler ('priv' in media_request_object_find). yes, literally 'priv', keep it cute and keep it exact. 🫶

---

🦋 DESCRIPTION 🦋

so what does she do? this function finds the control handler in the request. it may return NULL if not found — like, a totally valid “no thoughts, head empty” result. when you're done, you must call v4l2_ctrl_request_hdl_put with the returned handler pointer. like, actually must. 🔥

🚨 lowkey important: if the request is not in state VALIDATING or QUEUED, then this function will always return NULL. not sometimes. always. 💀

🧚 note that in state VALIDATING the req_queue_mutex is held, so no objects can be added or deleted from the request.

🌈 in state QUEUED it is the driver that will have to ensure this.

---

👑 SEE ALSO 👑

Kernel file ./include/media/v4l2-ctrls.h — plus the whole extended universe, bestie:

• union v4l2_ctrl_ptr(9), v4l2_ctrl_ptr_create(9), struct v4l2_ctrl_ops(9), struct v4l2_ctrl_type_ops(9), v4l2_ctrl_notify_fnc(9)
• struct v4l2_ctrl(9), struct v4l2_ctrl_ref(9), struct v4l2_ctrl_handler(9), struct v4l2_ctrl_config(9), v4l2_ctrl_fill(9)
• v4l2_ctrl_handler_init_class(9), v4l2_ctrl_handler_init(9), v4l2_ctrl_handler_free(9), v4l2_ctrl_lock(9), v4l2_ctrl_unlock(9)
• __v4l2_ctrl_handler_setup(9), v4l2_ctrl_handler_setup(9), v4l2_ctrl_handler_log_status(9), v4l2_ctrl_new_custom(9), v4l2_ctrl_new_std(9)
• v4l2_ctrl_new_std_menu(9), v4l2_ctrl_new_std_menu_items(9), v4l2_ctrl_new_std_compound(9), v4l2_ctrl_new_int_menu(9), v4l2_ctrl_filter(9)
• v4l2_ctrl_add_handler(9), v4l2_ctrl_radio_filter(9), v4l2_ctrl_cluster(9), v4l2_ctrl_auto_cluster(9), v4l2_ctrl_find(9)
• v4l2_ctrl_activate(9), __v4l2_ctrl_grab(9), v4l2_ctrl_grab(9), __v4l2_ctrl_modify_range(9), v4l2_ctrl_modify_range(9)
• __v4l2_ctrl_modify_dimensions(9), v4l2_ctrl_modify_dimensions(9), v4l2_ctrl_notify(9), v4l2_ctrl_get_name(9), v4l2_ctrl_get_menu(9)
• v4l2_ctrl_get_int_menu(9), v4l2_ctrl_g_ctrl(9), __v4l2_ctrl_s_ctrl(9), v4l2_ctrl_s_ctrl(9), v4l2_ctrl_g_ctrl_int64(9)
• __v4l2_ctrl_s_ctrl_int64(9), v4l2_ctrl_s_ctrl_int64(9), __v4l2_ctrl_s_ctrl_string(9), v4l2_ctrl_s_ctrl_string(9), __v4l2_ctrl_s_ctrl_compound(9)
• v4l2_ctrl_s_ctrl_compound(9), v4l2_ctrl_replace(9), v4l2_ctrl_merge(9), v4l2_ctrl_log_status(9), v4l2_ctrl_subscribe_event(9)
• v4l2_ctrl_poll(9), v4l2_ctrl_request_setup(9), v4l2_ctrl_request_complete(9), v4l2_ctrl_request_hdl_put(9), v4l2_ctrl_request_hdl_ctrl_find(9)
• v4l2_queryctrl(9), v4l2_query_ext_ctrl_to_v4l2_queryctrl(9), v4l2_query_ext_ctrl(9), v4l2_querymenu(9), v4l2_g_ctrl(9)
• v4l2_s_ctrl(9), v4l2_g_ext_ctrls(9), v4l2_try_ext_ctrls(9), v4l2_s_ext_ctrls(9), v4l2_ctrl_subdev_subscribe_event(9)
• v4l2_ctrl_subdev_log_status(9), v4l2_ctrl_new_fwnode_properties(9), v4l2_ctrl_type_op_equal(9), v4l2_ctrl_type_op_init(9), v4l2_ctrl_type_op_log(9)
• v4l2_ctrl_type_op_validate(9)

---

mwah 💋 that's the whole page! this lil beauty lives in ./include/media, is dated October 2026, and is the v4l2_ctrl_request_hdl_find(9) page from the Kernel API Manual. periodt. 🫶