Kernel Functions for Drivers             ddiintrgetpending(9F)



NAME
     ddiintrgetpending - get pending bit for a given interrupt

SYNOPSIS
     #include 
     #include 
     #include 
     #include 

     int ddiintrgetpending(ddiintrhandlet h, int *pendingp);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI).

PARAMETERS
     h           DI interrupt handle


     pendingp    Pointer to the pending capability  returned  for
                 this handle


DESCRIPTION
     The ddiintrgetpending() function returns non-zero as  the
     integer pointed to by the pendingp argument if a correspond-
     ing interrupt is pending. The corresponding interrupt handle
     h must already be allocated. The call succeeds if the device
     or host bridge supports the ability to  read  the  interrupt
     pending  bits  of  its  interrupts.  The  driver  should use
     ddiintrgetcap()    function     to     see     if     the
     DINTRFLAGPENDING  flag  is  returned  to  indicate that
     interrupts support interrupt pending bits.


     If the DINTRFLAGPENDING capability  is  not  supported,
     ddiintrgetpending()  returns DIENOTSUP and zero in pen-
     dingp.

RETURN VALUES
     The ddiintrgetpending() function returns:

     DISUCES    On success.


     DIEINVAL     On encountering invalid input parameters.


     DIFAILURE    On any implementation specific failure.






SunOS 5.11           Last change: 07Apr 2005                    1






Kernel Functions for Drivers             ddiintrgetpending(9F)



     DIENOTSUP    On device not supporting operation.


CONTEXT
     The  ddiintrgetpending()  function  can  be  called  from
     either user or kernel non-interrupt context.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    


SEE ALSO
     attributes(5),                    ddiintrblockenable(9F),
     ddiintrblockdisable(9F),           ddiintrclrmask(9F),
     ddiintrdisable(9F),                   ddiintrenable(9F),
     ddiintrsetmask(9F)


     Writing Device Drivers

NOTES
     Any consumer of this interface should verify that the return
     value  is  not equal to DISUCES. Incomplete checking for
     failure codes could result in  inconsistent  behavior  among
     platforms.





















SunOS 5.11           Last change: 07Apr 2005                    2