v4l2_ctrl_new_std_compound(9)

📦 version 7.3.1, in nixpkgs unstable

💅 v4l2_ctrl_new_std_compound — the Kernel API Manual glow-up 🎀

okay bestie, grab your boba because we're diving into v4l2_ctrl_new_std_compound from the Kernel API Manual and honestly? it's giving "small function, big responsibilities" ✨

✨ NAME ✨

v4l2_ctrl_new_std_compound — allocates AND initializes a brand-new standard V4L2 compound control. that's it, that's the whole vibe. 💖

🦋 SYNOPSIS 🦋

struct v4l2_ctrl * v4l2_ctrl_new_std_compound (struct v4l2_ctrl_handler
*hdl , const struct v4l2_ctrl_ops *ops , u32 id , const union
v4l2_ctrl_ptr p_def , const union v4l2_ctrl_ptr p_min , const union
v4l2_ctrl_ptr p_max );

like, six arguments, one function, zero chill. 😭

🌸 ARGUMENTS 🌸

  • hdl — the control handler. the main character, the one who holds everything together 🫶
  • ops — the control ops. the whole personality of the control, ngl
  • id — the control ID. your control's little name tag 🎀
  • p_def — the control's default value. the factory settings era ✨
  • p_min — the control's minimum value. the floor, literally
  • p_max — the control's maximum value. the ceiling, the limit, the "no further" 💅

👑 DESCRIPTION 👑

so this one is same as v4l2_ctrl_new_std — but with support for compound controls 💖 say it back.

to fill in the p_def, p_min and p_max fields, you use v4l2_ctrl_ptr_create to convert a pointer to a const union v4l2_ctrl_ptr. cute, right?

and here's the slay shortcut: use v4l2_ctrl_ptr_create(NULL) if you want the default, minimum or maximum value of the compound control to be all zeroes. zeroes everywhere, no notes. ⭐

okay and this part matters — if the compound control does not set the V4L2_CTRL_FLAG_HAS_WHICH_MIN_MAX flag, then it doesn't have minimum and maximum values. so in that case just use v4l2_ctrl_ptr_create(NULL) for the p_min and p_max arguments. no min, no max, no problem 🦋

bestie pls don't skip this part, it's the whole plot 🙈

💜 SEE ALSO 💜

the crossover episode nobody asked for but everybody needed — the kernel file ./include/media/v4l2-ctrls.h and the entire ctrl extended universe:

like, it's a whole friend group at this point 💀

and that's the tea ☕ — this page lives in ./include/media, dated October 2026, and it's part of the Kernel API Manual. mwah, go write some compound controls bestie 💖✨🎀🦋💅

📦 where this page comes from