DDI_REMOVE_EVENT_HANDLER(9F) Kernel Functions for Drivers

NAME

ddi_remove_event_handler - remove an NDI event service callback
handler

SYNOPSIS

#include <sys/dditypes.h>
#include <sys/sunddi.h>

int ddi_remove_event_handler(ddi_registration_id_t id);

INTERFACE LEVEL

illumos DDI specific (illumos DDI).

PARAMETERS

ddi_registration_id_t id
Unique system wide registration ID return
by ddi_add_event_handler(9F) upon
successful registration.

DESCRIPTION

The ddi_remove_event_handler() function removes the callback handler
specified by the registration id (ddi_registration_id_t). Upon
successful removal, the callback handler is removed from the system
and will not be invoked in the face of the event.

RETURN VALUES

DDI_SUCCESS
Callback handler removed successfully.


DDI_FAILURE
Failed to remove callback handler.

CONTEXT

The ddi_remove_event_handler() function can be called from user and
kernel contexts only.

ATTRIBUTES

See attributes(7) for a description of the following attributes:


+----------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+----------------+-----------------+
|Stability Level | Committed |
+----------------+-----------------+

SEE ALSO

attributes(7), ddi_add_event_handler(9F), ddi_get_eventcookie(9F)


Writing Device Drivers

NOTES

Device drivers must remove all registered callback handlers before
detach(9E) processing for that device instance is complete.

May 2, 2003 DDI_REMOVE_EVENT_HANDLER(9F)