STRUCT V4L2_SUBDEV_STATE(9)

📦 version 7.3.1, in nixpkgs unstable

💅 struct v4l2_subdev_state(9) — the Kernel API Manual, bestie edition ✨

okay so this is a page from the Kernel API Manual, and it's all about struct v4l2_subdev_state 🎀

✨ NAME ✨

struct v4l2_subdev_state — literally the place where subdev state info lives, no cap 💾✨

🌸 SYNOPSIS 🌸

struct v4l2_subdev_state {
    struct mutex _lock;
    struct mutex *lock;
    struct v4l2_subdev *sd;
    struct v4l2_subdev_pad_config *pads;
    struct v4l2_subdev_krouting routing;
    struct v4l2_subdev_stream_configs stream_configs;
 };

🦋 Members 🦋

the cast of the struct, one by one 👑

  • _lock — the default for lock. she's the built-in backup plan, the understudy, the reserve 💅
  • lock — the mutex for the state. the user is allowed to replace this one, so it's giving "customizable but make it thread-safe" 🫶
  • sd — the sub-device that this state is related to. every state has a subdev, that's the whole point 💖
  • pads — a struct v4l2_subdev_pad_config array. yes, an array, not one lil thing 🌈
  • routing — the routing table for the subdev. routes as far as the eye can see 🛣️
  • stream_configs — stream configurations, and super important: only for V4L2_SUBDEV_FL_STREAMS. if you're not flagged, this one's not for you 🙈

🌟 Description 🌟

bestie listen, here's the vibe check on when you actually hand this thing over 👇

This structure only needs to be passed to the pad op if the 'which' field of the main argument is set to V4L2_SUBDEV_FORMAT_TRY. For V4L2_SUBDEV_FORMAT_ACTIVE it is safe to pass NULL.

that's it, that's the rule — TRY mode? you need her. ACTIVE mode? NULL is literally fine, she's off duty 💀✨

🔥 SEE ALSO 🔥

Kernel file ./include/media/v4l2-subdev.h

and now, the guest list — everyone's invited, it's a whole party fr fr 🎉👑

and that's the whole page, bestie 🫶 this one came out of ./include/media, dated October 2026 — a lil vintage moment, iconic honestly 💜✨👑

📦 where this page comes from