STRUCT SSAM_EVENT_ITEM(9)

💅 struct_ssam_event_item(9) 💅

okay so bestie, we're deep in the Kernel API Manual rn — section 9, the fancy kernel-API one — and this page is literally all about struct ssam_event_item. it's giving "queue girlie" energy and honestly? iconic.

---

✨ NAME ✨

struct ssam_event_item — the struct for event queuing and completion. that's it, that's the whole vibe. 🎀

---

🌸 SYNOPSIS 🌸

ok so here's the actual shape of it, copy it exactly bestie, no cap:

struct ssam_event_item {
    struct list_head node;
    u16 rqid;
    struct {
      void (*free)(struct ssam_event_item *event);
    } ops;
    struct ssam_event event;
 };

---

🦋 Members 🦋

bestie we are going member by member because every single one matters, periodt:

• node — the node in the queue. that's its whole job. it's the main character of the queue, lowkey.
• rqid — the request ID of the event. u16, very demure, very mindful.
• ops — instance specific functions. this is the little nested struct where the customization lives 💅
• ops.free — the callback for freeing this event item. it's a void (*free)(struct ssam_event_item *event); and yes, you gotta call it, don't leave your event items hanging 😭
• event — the actual event data. the struct ssam_event in question. the reason for the season fr fr.

---

👑 SEE ALSO 👑

okay so this is the part where I point you at all the other pages, and there are a lot of them, so buckle up bestie:

• the kernel file ./drivers/platform/surface/aggregator/controller.h
• struct ssh_seq_counter(9)
• struct ssh_rqid_counter(9)
• struct ssam_nf_head(9)
• struct ssam_nf(9)
• struct ssam_event_queue(9)
• struct ssam_event_target(9)
• struct ssam_cplt(9)
• enum ssam_controller_state(9)
• struct ssam_controller_caps(9)
• struct ssam_controller(9)
• ssam_controller_receive_buf(9)
• ssam_controller_write_wakeup(9)

like I said. a lot. go read them, iykyk 🫶

---

ngl bestie, if you're touching the queue you gotta respect the ops.free callback or you're gonna have a bad time. that's not me being dramatic, that's just the struct. 💀

---

mwah 💖 that's the page! this lil gem comes to you from ./drivers/platform/surface/agg... and it's dated October 2026 — so go forth, queue your events, complete them, and slay ✨🌈⭐