v4l2_s_ext_ctrls(9)

📦 version 7.3.1, in nixpkgs unstable

💅 v4l2_s_ext_ctrls(9) — from the Kernel API Manual, bestie ✨

okay so picture this: you're deep in the kernel, you're doing V4L2 things, and you need a little helper. that's her. that's the main character. this page lives in the Kernel API Manual and she's here to make your ioctl dreams come true 🫶

🌸 NAME 🌸

v4l2_s_ext_ctrls — the helper function that implements the :ref:VIDIOC_S_EXT_CTRLS <vidioc_g_ext_ctrls> ioctl. literally her whole job. iconic 👑

✨ SYNOPSIS ✨

int v4l2_s_ext_ctrls (struct v4l2_fh *fh , struct v4l2_ctrl_handler *hdl
, struct video_device *vdev , struct media_device *mdev , struct
v4l2_ext_controls *c );

that's five pointers and an int, and yes you have to pass all of them, no skipping, no shortcuts 💀

🎀 ARGUMENTS 🎀

  • fh — pointer to struct v4l2_fh. the file handle vibe ✨
  • hdl — pointer to struct v4l2_ctrl_handler. the control handler herself, keep an eye on this one 👀
  • vdev — pointer to struct video_device. your video device bestie 📹
  • mdev — pointer to struct media_device. media device, also a pointer, also invited to the party 🦋
  • c — pointer to struct v4l2_ext_controls. the extended controls crew, all bundled up 💜

🔥 DESCRIPTION 🔥

so like, real talk: if hdl == NULL then they will all return -EINVAL. that's it. that's the lore. no cap, that's the documented behaviour — null handler? -EINVAL for everybody, no exceptions, the end 🙈

lowkey a vibe check on your handler pointer before you even call this. just saying. 💅

🌈 SEE ALSO 🌈

the friend group is huge and every single one of them is invited, so buckle up bestie 🎀

like I said. huge friend group. every single one linked, none left on read 💖

okay that's the whole page, you ate that 🍓 this little beauty ships out of ./include/media and the version stamp on her is October 2026 — so she's, like, extremely current. go forth and set those extended controls, bestie, and remember: check your hdl first 😭💜

📦 where this page comes from