media_entity_pads_init(9)

✨ media_entity_pads_init(9) ✨

okay so this is a page straight out of the Kernel API Manual, and honestly? it's giving "small function, big responsibilities" 💅 buckle up bestie, we're initializing some pads 🎀

---

🌸 NAME 🌸

media_entity_pads_init — Initialize the entity pads 🫶

---

⭐ SYNOPSIS ⭐

int media_entity_pads_init (struct media_entity *entity , u16 num_pads ,
       struct media_pad *pads );

---

💖 ARGUMENTS 💖

• entity — the entity where the pads belong, iykyk 🦋
• num_pads — the total number of sink and source pads, like, all of them combined ✨
• pads — an array of num_pads pads. yes, that many 🍓

---

👑 DESCRIPTION 👑

So the pads array is managed by the entity driver, right? and it gets passed into media_entity_pads_init, where its pointer will be stored in the media_entity structure. simple. iconic. no cap 💅

If no pads are needed — like, zero, none, we're good — drivers could either directly fill media_entity->num_pads with 0 and media_entity->pads with NULL, or call this function that will do the same thing anyway. either way slays 🌈

And here's the cute part: as the number of pads is known in advance, the pads array is not allocated dynamically — it's managed by the entity driver. Most drivers will embed the pads array in a driver-specific structure, avoiding dynamic allocation entirely. efficiency queen behavior fr fr 👑

⚠️ okay this one's important: drivers must set the direction of every pad in the pads array before calling media_entity_pads_init. the function will initialize the other pads fields, but the direction? that's on you bestie 😭

---

🦋 SEE ALSO 🦋

Kernel file ./include/media/media-entity.h, plus a whole friend group of references — every single one of them, no skips 🔥

• enum media_gobj_type(9)
• struct media_gobj(9)
• struct media_entity_enum(9)
• struct media_graph(9)
• struct media_pipeline(9)
• struct media_pipeline_pad(9)
• struct media_pipeline_pad_iter(9)
• struct media_pipeline_entity_iter(9)
• struct media_link(9)
• enum media_pad_signal_type(9)
• struct media_pad(9)
• struct media_entity_operations(9)
• enum media_entity_type(9)
• struct media_entity(9)
• media_entity_for_each_pad(9)
• struct media_interface(9)
• struct media_intf_devnode(9)
• media_entity_id(9)
• media_type(9)
• media_id(9)
• media_gobj_gen_id(9)
• is_media_entity_v4l2_video_device(9)
• is_media_entity_v4l2_subdev(9)
• media_entity_enum_init(9)
• media_entity_enum_cleanup(9)
• media_entity_enum_zero(9)
• media_entity_enum_set(9)
• media_entity_enum_clear(9)
• media_entity_enum_test(9)
• media_entity_enum_test_and_set(9)
• media_entity_enum_empty(9)
• media_entity_enum_intersects(9)
• gobj_to_entity(9)
• gobj_to_pad(9)
• gobj_to_link(9)
• gobj_to_intf(9)
• intf_to_devnode(9)
• media_gobj_create(9)
• media_gobj_destroy(9)
• media_entity_cleanup(9)
• media_get_pad_index(9)
• media_create_pad_link(9)
• media_create_pad_links(9)
• media_entity_remove_links(9)
• __media_entity_setup_link(9)
• media_entity_setup_link(9)
• media_entity_find_link(9)
• media_pad_remote_pad_first(9)
• media_pad_remote_pad_unique(9)
• media_entity_remote_pad_unique(9)
• media_entity_remote_source_pad_unique(9)
• media_pad_is_streaming(9)
• media_entity_is_streaming(9)
• media_entity_pipeline(9)
• media_pad_pipeline(9)
• media_entity_get_fwnode_pad(9)
• media_graph_walk_init(9)
• media_graph_walk_cleanup(9)
• media_graph_walk_start(9)
• media_graph_walk_next(9)
• media_pipeline_start(9)
• __media_pipeline_start(9)
• media_pipeline_stop(9)
• __media_pipeline_stop(9)
• media_pipeline_for_each_pad(9)
• media_pipeline_entity_iter_init(9)
• media_pipeline_entity_iter_cleanup(9)
• media_pipeline_for_each_entity(9)
• media_pipeline_alloc_start(9)
• media_devnode_create(9)
• media_devnode_remove(9)
• media_create_intf_link(9)
• __media_remove_intf_link(9)
• media_remove_intf_link(9)
• __media_remove_intf_links(9)
• media_remove_intf_links(9)
• media_entity_call(9)
• media_create_ancillary_link(9)
• __media_entity_next_link(9)
• for_each_media_entity_data_link(9)

like I said. the whole group chat 🫶

---

and that's the whole page bestie!! 💜 this one lives in ./include/media, dropped October 2026, and it's literally called media_entity_pads_init(9) — go forth and initialize those pads responsibly, mwah 🧚💖