Kernel Functions for Drivers              ddigeteventcookie(9F)



NAME
     ddigeteventcookie - retrieve a NDI  event  service  cookie
     handle

SYNOPSIS
     #include 
     #include 

     int ddigeteventcookie(devinfot *dip, char *name,
          ddieventcookiet *eventcookiep);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI).

PARAMETERS
     devinfot *dip

         Child device node requesting the cookie.


     char *name

         NUL-terminated string containing the name of the event.


     ddieventcookiet *eventcookiep

         Pointer to cookie where event cookie will be returned.


DESCRIPTION
     The ddigeteventcookie() 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 a  cal-
     ling  up  the  device  tree  hierarchy  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, unregister a callback handler, or post
     an event.

RETURN VALUES
     DISUCES    Cookie handle is returned.


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




SunOS 5.11           Last change: 6 Nov 2003                    1






Kernel Functions for Drivers              ddigeteventcookie(9F)



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

ATRIBUTES
     See attributes(5) for a description of the following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    


SEE ALSO
     attributes(5),                    ddiaddeventhandler(9F),
     ddiremoveeventhandler(9F)


     Writing Device Drivers
































SunOS 5.11           Last change: 6 Nov 2003                    2