media_request_get_by_fd(9)

💅 media_request_get_by_fd(9) 💅

okay bestie, we’re in the Kernel API Manual and this page is about grabbing a media request by its fd — it’s giving “you have a file descriptor, now get the request” energy. 🦋✨

🌸 NAME 🌸

media_request_get_by_fd — get a media request by fd. Literally what it says on the tin. No cap. 💖

✨ SYNOPSIS ✨

struct media_request * media_request_get_by_fd (struct media_device
       *mdev , int request_fd );

🎀 ARGUMENTS 🎀

• mdev — the media device this request belongs to. Like, whose request is it? This device’s request. 🫶
• request_fd — the file descriptor of the request. The fd in question, bestie. 🔥

💖 DESCRIPTION 💖

okay so here’s the tea: this function gets the request represented by request_fd that is owned by the media device. 🧚

• If requests are not supported by this driver, it returns a -EBADR error pointer. Not the vibe, but important. 😭
• If the request was not found, it returns -EINVAL. Bestie, check that fd. 💀
• If the request is found, you get the pointer to the request — but listen, the caller will have to call media_request_put when it finished using the request. That’s the cleanup rule, periodt. 💅✨

reminder: the caller will have to call media_request_put when it finished using the request. don’t leave it hanging, okay? 🫶

🌈 SEE ALSO 🌈

• Kernel file ./include/media/media-request.h
• 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_alloc(9)
• media_request_mark_manual_completion(9)
• media_request_manual_complete(9)
• struct media_request_object_ops(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)

mwah 💋 that’s the whole page, bestie — source/version is ./include/media and the date is October 2026. stay hydrated, remember media_request_put, and slay your media requests 🫶💖🎀