v4l2_subdev_...e_get_format(9)

📦 version 7.3.1, in nixpkgs unstable

💅 v4l2_subdev_state_get_format(9) — a Kernel API Manual moment 🎀

okay so bestie, we're in the Kernel API Manual today and I need you to lock in for like 30 seconds because this one is actually so chill once you get it. it's giving "find my format" energy and honestly? iconic.

✨ NAME ✨

v4l2_subdev_state_get_format — Get pointer to a stream format 🫶

🦋 SYNOPSIS 🦋

v4l2_subdev_state_get_format (state , pad , ... );

like literally just those three things, no cap ✨

🌸 ARGUMENTS 🌸

  • state — the subdevice state, your main character struct 💜
  • pad — the pad id, iykyk 🎀
  • ... — the stream id, and it's optional (yes bestie, you can skip it, she's flexible 🌈)

👑 DESCRIPTION 👑

so what does she actually do? This returns a pointer to struct v4l2_mbus_framefmt for the given pad + stream in the subdev state. that's it. that's the whole vibe. you give her a pad and a stream, she hands you a pointer to the framefmt. slay 💅

and for the stream-unaware drivers out there — you know, the ones that aren't doing the whole stream thing — the format for the corresponding pad is returned. she's got you either way, fr fr 🧚

⚠️ but listen: if the pad does not exist, NULL is returned. so please, for the love of everything, check your pointer before you dereference it 😭 that's not a fun crash to debug, trust.

🌟 SEE ALSO 🌟

okay this list is long but I promised I would not skip a single one because every detail matters bestie 💖 starting with the kernel file ./include/media/v4l2-subdev.h and then:

like I said. long. but she ate and left no crumbs 🍓

and that's the whole page bestie!! 💖 this lil cutie lives over in ./include/media, dated October 2026, and she goes by v4l2_subdev_...e_get_format(9) if you ever need to find her again. mwah 🫶✨

📦 where this page comes from