v4l2_subdev_disable_streams(9)

💅 v4l2_subdev_disable_streams ✨

Hey bestie, welcome to the Kernel API Manual — this one's all about turning streams off, and honestly? It's giving "closing the group chat for the night" energy. 🦋

---

🌸 NAME 🌸

v4l2_subdev_disable_streams — the girlies who disable streams on a pad 🎀

---

✨ SYNOPSIS ✨

int v4l2_subdev_disable_streams(struct v4l2_subdev *sd, u32 pad, u64 streams_mask);

---

💖 ARGUMENTS 💖

• sd — the subdevice, aka the main character 🫶
• pad — the pad. that's it, that's the whole thing 💅
• streams_mask — a bitmask of the streams you wanna disable 😴

---

🦋 DESCRIPTION 🦋

Okay so, this function disables streams on a source pad of a subdevice. The pad gets identified by its index, and the streams get identified by the streams_mask bitmask. Which means — and this is the slay part — you can disable multiple streams on a pad at once. efficiency, we love to see it. 🔥

⚠️ But listen, bestie: disabling a stream that isn't enabled is not allowed. If streams_mask contains a stream that's already disabled, this function returns -EALREADY and does absolutely nothing else — no partial work, no half-vibes. 🚫

Per-stream disable is only available for subdevs that implement the .enable_streams and .disable_streams operations. For the other subdevs, this function does a best-effort compatibility thing by calling the .s_stream operation — but that's limited to subdevs that have a single source pad. Iykyk. 🌈

Drivers that are not stream-aware shall set streams_mask to BIT_ULL(0). Lowkey important, don't skip it. 👑

---

⭐ RETURN ⭐

• 0 — success, we ate 💅✨
• -EALREADY — one of the streams in streams_mask is not enabled 😭
• -EINVAL — the pad index is invalid, or it doesn't correspond to a source pad 🙈
• -EOPNOTSUPP — falling back to the legacy .s_stream operation is impossible because the subdev has multiple source pads 💀

---

🎀 SEE ALSO 🎀

Kernel file ./include/media/v4l2-subdev.h struct, plus the whole extended friend group:

• 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_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_call_state_try(9)
• v4l2_subdev_has_op(9)
• v4l2_subdev_notify_event(9)
• v4l2_subdev_is_streaming(9)

---

and that's the whole page, bestie 💖 This lil' icon lives down in ./include/media, and the manual's serving October 2026 energy — so if you're reading this in the future, hiii, hope the streams are all behaving 🧚‍♀️💜