v4l2_subdev...state_active(9)

Okay bestie, welcome to v4l2_subdev_call_state_active — the page is v4l2_subdev...state_active(9), from the Kernel API Manual — and it's literally the “grab the active state, lock it, call the op, unlock it” macro. No cap. ✨

💖 NAME 💖

v4l2_subdev_call_state_active — call an operation of a v4l2_subdev which takes state as a parameter, passing the subdev its active state. 💅

✨ SYNOPSIS ✨

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

🎀 ARGUMENTS 🎀

• sd — pointer to the struct v4l2_subdev. That's your subdev bestie. 🫶
• o — name of the element at struct v4l2_subdev_ops that contains f. Each element there groups a set of callback functions. So it's like picking the right group chat for the callback. ✨
• f — callback function to be called. The callback functions are defined in groups, according to each element at struct v4l2_subdev_ops. It's giving organized friend-group energy. 💅
• args — arguments for f. Whatever the callback needs, hand it over. 🎀

🦋 DESCRIPTION 🦋

Okay so this is similar to v4l2_subdev_call, except that this version can only be used for ops that take a subdev state as a parameter. Highkey important: only those ops. 👑

The macro will get the active state, lock it before calling the op and unlock it after the call. So it's doing the state-wrangling for you, and that's iconic. 💅

👑 SEE ALSO 👑

Then the whole sparkly reference squad, because the kernel loves a linked list of friends:

• Kernel file ./include/media/v4l2-subdev.h struct — the home base.
• 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_try(9)
• v4l2_subdev_has_op(9), v4l2_subdev_notify_event(9), v4l2_subdev_is_streaming(9)

That's the whole page, bestie! Footer vibes: source path ./include/media, version/date October 2026, and page title v4l2_subdev...state_active(9). Mwah 💋.