STRUCT MEDIA_REQUEST_OBJECT_OPS(9)

🎀 struct media_request_object_ops(9) — the Kernel API Manual bestie edition 🎀

okay so picture this: you're deep in the Kernel API Manual (yes, that one, section 9, we love her) and you bump into struct media_request_object_ops. That's the vibe. It's literally the vtable of callbacks that tells a media request object how to behave — prep, queue, unbind, the whole little lifecycle. Let's get into it 💅

---

✨ NAME ✨

struct media_request_object_ops — Media request object operations. that's it, that's the whole name, and honestly? iconic. 🫶

---

🌸 SYNOPSIS 🌸

here's the whole struct, copied exactly, no cap, don't touch a single character:

struct media_request_object_ops {
    int (*prepare)(struct media_request_object *object);
    void (*unprepare)(struct media_request_object *object);
    void (*queue)(struct media_request_object *object);
    void (*unbind)(struct media_request_object *object);
    void (*release)(struct media_request_object *object);
 };

look at her. five function pointers. main character energy for real 🔥

---

💖 Members 💖

• prepare — Validate and prepare the request object. It's optional, so if you don't vibe with it you can absolutely skip it. returns int, so she's got opinions 👀
• unprepare — Unprepare the request object. also optional. the undoing of the doing, we stan a clean rollback ✨
• queue — Queue the request object. optional again. get her in line, bestie 🌈
• unbind — Unbind the request object. optional. letting go era 🦋
• release — Release the request object. REQUIRED. not optional, not "if you feel like it", not "maybe later". you must implement this one. periodt. 👑

lowkey the pattern here is: everything is optional except release. don't be the person who forgets release. don't be her. 😭

---

👑 SEE ALSO 👑

the kernel file this lives in is ./include/media/media-request.h, and it's giving very much "here's the whole friend group". go say hi to all of them:

• enum media_request_state(9)
• struct media_request(9)
• media_request_lock_for_access(9)
• media_request_unlock_for_access(9)
• media_request_lock_for_update(9)
• media_request_unlock_for_update(9)
• media_request_get(9)
• media_request_put(9)
• media_request_get_by_fd(9)
• media_request_alloc(9)
• media_request_mark_manual_completion(9)
• media_request_manual_complete(9)
• struct media_request_object(9)
• media_request_object_get(9)
• media_request_object_put(9)
• media_request_object_find(9)
• media_request_object_init(9)
• media_request_object_bind(9)
• media_request_object_unbind(9)
• media_request_object_complete(9)

---

and that's the whole page, bestie, you ate that 🍓 this lil gem lives in ./include/media and it's stamped October 2026 — so yeah, she's from the future and she's still slaying. mwah 💋✨