ssam_nf_refcount_inc(9)

✨ ssam_nf_refcount_inc ✨

okay so you're in the Kernel API Manual bestie, and today's main character is ssam_nf_refcount_inc — the little function that bumps the refcount on an event. slay. let's get into it 💅

---

🌸 NAME 🌸

ssam_nf_refcount_inc — increments the reference-/activation-count of the given event. that's it. that's the whole vibe. ✨

---

🦋 SYNOPSIS 🦋

struct ssam_nf_refcount_entry * ssam_nf_refcount_inc (struct ssam_nf *nf
, struct ssam_event_registry reg , struct ssam_event_id id );

look at her. three params, returns a pointer, fully iconic. 👑

---

🎀 ARGUMENTS 🎀

• nf — the notifier system reference. your notifier-system bestie, basically.
• reg — the registry used to enable/disable the event. this is the one that says "hey, turn this on/off."
• id — the event ID. the event's whole identity, honestly.

---

💖 DESCRIPTION 💖

so what she does: she increments the reference-/activation-count that's associated with the specified event type/ID. and if there's no entry for that event ID yet? she allocates a new one for you. no big deal. 🫶

and just so we're clear — a newly allocated entry will have a refcount of one. not zero. one. got it? ✨

---

⚠️ NOTE ⚠️

nf->lock must be held when calling this function. like, actually must. this is not a suggestion, bestie. hold the lock. 🔒💀

---

🌈 RETURN 🌈

• on success: returns the refcount entry. 🎉
• on sadness: returns an error pointer with -ENOSPC if there have already been INT_MAX events of the specified ID and type registered 😭
• or an error pointer with -ENOMEM if the entry could not be allocated. rough out here fr fr.

---

👑 SEE ALSO 👑

the kernel file: ./drivers/platform/surface/aggregator/controller.c

and the whole friend group, no cap — every single one:

• ssh_seq_reset(9), ssh_seq_next(9), ssh_rqid_reset(9), ssh_rqid_next(9)
• ssam_event_matches_notifier(9), ssam_nfblk_call_chain(9), ssam_nfblk_insert(9), ssam_nfblk_find(9), ssam_nfblk_remove(9)
• ssam_nf_head_init(9), ssam_nf_head_destroy(9)
• struct ssam_nf_refcount_key(9), struct ssam_nf_refcount_entry(9)
• ssam_nf_refcount_dec(9), ssam_nf_refcount_dec_free(9), ssam_nf_refcount_empty(9)
• ssam_nf_call(9), ssam_nf_init(9), ssam_nf_destroy(9)
• ssam_event_item_cache_init(9), ssam_event_item_cache_destroy(9), ssam_event_item_free(9), ssam_event_item_alloc(9)
• ssam_event_queue_push(9), ssam_event_queue_pop(9), ssam_event_queue_is_empty(9)
• ssam_cplt_get_event_queue(9), ssam_cplt_submit(9), ssam_cplt_submit_event(9), ssam_cplt_flush(9), ssam_event_queue_init(9), ssam_cplt_init(9), ssam_cplt_destroy(9)
• ssam_controller_device(9), ssam_controller_get(9), ssam_controller_put(9), ssam_controller_statelock(9), ssam_controller_stateunlock(9), ssam_controller_lock(9)
• ssam_controller_caps_load_from_acpi(9), ssam_controller_caps_load_from_of(9), ssam_controller_caps_load(9)
• ssam_controller_init(9), ssam_controller_start(9), ssam_controller_shutdown(9), ssam_controller_destroy(9), ssam_controller_suspend(9), ssam_controller_resume(9)
• ssam_request_write_data(9), ssam_request_sync_alloc(9), ssam_request_sync_free(9), ssam_request_sync_init(9), ssam_request_sync_submit(9), ssam_request_do_sync(9), ssam_request_do_sync_with_buffer(9)
• struct ssh_notification_params(9)
• ssam_ssh_event_enable(9), ssam_ssh_event_disable(9)
• ssam_get_firmware_version(9)
• ssam_ctrl_notif_display_off(9), ssam_ctrl_notif_display_on(9), ssam_ctrl_notif_d0_exit(9), ssam_ctrl_notif_d0_entry(9)
• ssam_nf_refcount_enable(9), ssam_nf_refcount_disable_free(9)
• ssam_notifier_register(9), __ssam_notifier_unregister(9)
• ssam_controller_event_enable(9), ssam_controller_event_disable(9)
• ssam_notifier_disable_registered(9), ssam_notifier_restore_registered(9), ssam_notifier_is_empty(9), ssam_notifier_unregister_all(9)
• ssam_irq_setup(9), ssam_irq_free(9), ssam_irq_arm_for_wakeup(9), ssam_irq_disarm_wakeup(9)

that's the whole group chat right there, iykyk 💜

---

and that's the page!! brought to you by the source <code>./drivers/platform/surface/agg...</code> and dated October 2026 — mwah, xoxo, go hold that lock 💋✨🎀