Kernel Functions for Drivers              ldigeteventcookie(9F)



NAME
     ldigeteventcookie - retrieve NDI event service cookie

SYNOPSIS
     #include 

     int ldigeteventcookie(ldihandlet lh, char *name
          ddieventcookiet *ecp);


INTERFACE LEVEL
     Obsolete

PARAMETERS
     ldihandlet lh           Layered handle.


     char *name                null-terminated string  containing
                               the event name.


     ddieventcookiet *ecp    Pointer  to   the   kernel   event
                               cookie.


DESCRIPTION
     This function is obsolete and is only maintained for  compa-
     tibility.  Use of this function is strongly discouraged. For
     equivalent functionality provided  by  new  interfaces,  see
     ldievgetcookie(9F) and ldievregistercallbacks(9F).


     The ldigeteventcookie() function queries the  device  tree
     for  a  cookie  matching  the given event name and returns a
     reference to that cookie. The search is performed by calling
     up  the device tree hierarchy of the  device  represented by
     the layered driver handle until the request is satisfied  by
     a  bus  nexus  driver,   or  the top of the devinfo tree is
     reached.


     The cookie returned by this function can be used to register
     a callback handler with ldiaddeventhandler(9F).

RETURN VALUES
     DISUCES    Cookie handle is returned.


     DIFAILURE    Request was  not  serviceable  by  any  nexus
                    driver  in the target device's ancestral dev-
                    ice tree hierarchy.




SunOS 5.11          Last change: 21 Aug 2007                    1






Kernel Functions for Drivers              ldigeteventcookie(9F)



CONTEXT
     This function may be called from user or kernel contexts.

SEE ALSO
     ldievgetcookie(9F),        ldievregistercallbacks(9F),
     ldiaddeventhandler(9F), ldiremoveeventhandler(9F)


     Writing Device Drivers














































SunOS 5.11          Last change: 21 Aug 2007                    2