v4l2_subdev_call_state_try(9)

🎀 NAME 🎀

okay bestie, welcome to the v4l2_subdev_call_state_try(9) page from the Kernel API Manual. this one calls an operation of a v4l2_subdev which takes state as a parameter, and it passes the subdev a newly allocated try state. periodt. ✨

---

✨ SYNOPSIS ✨

v4l2_subdev_call_state_try (sd , o , f , args... );

---

🦋 ARGUMENTS 🦋

• sd — pointer to the struct v4l2_subdev. literally the subdev in question, your main character 💅
• o — name of the element at struct v4l2_subdev_ops that contains f. Each element there groups a set of callbacks functions. iykyk, it’s the ops bucket 🎀
• f — callback function to be called. The callback functions are defined in groups, according to each element at struct v4l2_subdev_ops. so fetch the right callback, bestie 🫶
• args — arguments for f. yes, the little snack pack that gets passed through 🍓

---

🌸 DESCRIPTION 🌸

This is similar to v4l2_subdev_call_state_active, except that as this version allocates a new state, this is only usable for V4L2_SUBDEV_FORMAT_TRY use cases.

no cap: this version is the “new state, who dis” one, and it’s strictly for V4L2_SUBDEV_FORMAT_TRY scenarios. the original says it, I’m just saying it with glitter ✨

---

💀 NOTE 💀

only legacy non-MC drivers may need this macro.

that’s the whole note, bestie — don’t @ me 💀

---

🌈 SEE ALSO 🌈

• Kernel file ./include/media/v4l2-subdev.h struct, v4l2_decode_vbi_line(9), enum v4l2_subdev_io_pin_bits(9), struct v4l2_subdev_io_pin_config(9), struct v4l2_subdev_core_ops(9), struct v4l2_subdev_tuner_ops(9)
• struct v4l2_subdev_audio_ops(9), struct v4l2_mbus_frame_desc_entry_csi2(9), enum v4l2_mbus_frame_desc_flags(9), struct v4l2_mbus_frame_desc_entry(9), enum v4l2_mbus_frame_desc_type(9), struct v4l2_mbus_frame_desc(9)
• enum v4l2_subdev_pre_streamon_flags(9), struct v4l2_subdev_video_ops(9), struct v4l2_subdev_vbi_ops(9), struct v4l2_subdev_sensor_ops(9), enum v4l2_subdev_ir_mode(9), struct v4l2_subdev_ir_parameters(9)
• struct v4l2_subdev_ir_ops(9), struct v4l2_subdev_pad_config(9), struct v4l2_subdev_stream_configs(9), struct v4l2_subdev_krouting(9), struct v4l2_subdev_state(9), struct v4l2_subdev_pad_ops(9)
• struct v4l2_subdev_ops(9), struct v4l2_subdev_internal_ops(9), struct v4l2_subdev_platform_data(9), struct v4l2_subdev(9), media_entity_to_v4l2_subdev(9), vdev_to_v4l2_subdev(9)
• struct v4l2_subdev_fh(9), to_v4l2_subdev_fh(9), v4l2_set_subdevdata(9), v4l2_get_subdevdata(9), v4l2_set_subdev_hostdata(9), v4l2_get_subdev_hostdata(9)
• v4l2_subdev_get_fwnode_pad_1_to_1(9), v4l2_subdev_link_validate_default(9), v4l2_subdev_link_validate(9), v4l2_subdev_has_pad_interdep(9), __v4l2_subdev_state_alloc(9), __v4l2_subdev_state_free(9)
• v4l2_subdev_init_finalize(9), v4l2_subdev_cleanup(9), v4l2_subdev_state_get_format(9), v4l2_subdev_state_get_crop(9), v4l2_subdev_state_get_compose(9), v4l2_subdev_state_get_interval(9)
• v4l2_subdev_get_fmt(9), v4l2_subdev_get_frame_interval(9), v4l2_subdev_set_routing(9), for_each_active_route(9), v4l2_subdev_set_routing_with_fmt(9), v4l2_subdev_routing_find_opposite_end(9)
• v4l2_subdev_state_get_opposite_stream_format(9), v4l2_subdev_state_xlate_streams(9), enum v4l2_subdev_routing_restriction(9), v4l2_subdev_routing_validate(9), v4l2_subdev_enable_streams(9), v4l2_subdev_disable_streams(9)
• v4l2_subdev_s_stream_helper(9), __v4l2_subdev_get_frame_desc_passthrough(9), v4l2_subdev_get_frame_desc_passthrough(9), v4l2_subdev_lock_state(9), v4l2_subdev_unlock_state(9), v4l2_subdev_lock_states(9)
• v4l2_subdev_unlock_states(9), v4l2_subdev_get_unlocked_active_state(9), v4l2_subdev_get_locked_active_state(9), v4l2_subdev_lock_and_get_active_state(9), v4l2_subdev_init(9), v4l2_subdev_call(9)
• v4l2_subdev_call_state_active(9), v4l2_subdev_has_op(9), v4l2_subdev_notify_event(9), v4l2_subdev_is_streaming(9)

---

mwah 💋 this gem comes from ./include/media, dated October 2026, and it’s v4l2_subdev_call_state_try(9) signing off from the Kernel API Manual. go be iconic with those try states, bestie 🫶✨