Kernel Functions for Drivers     ddiintrgetsupportedtypes(9F)



NAME
     ddiintrgetsupportedtypes - return  information  on  sup-
     ported hardware interrupt types

SYNOPSIS
     #include 
     #include 
     #include 
     #include 

     int ddiintrgetsupportedtypes(devinfot *dip, int *typesp);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI)

PARAMETERS
     dip       Pointer to devinfo structure


     typesp    Pointer to supported interrupt types


DESCRIPTION
     The ddiintrgetsupportedtypes()  function  retrieves  the
     interrupt  types  supported  by a particular hardware device
     and by the system software. Upon successful return, the sup-
     ported  types  are  returned  as  a  bit mask in the integer
     pointed to by the typesp argument. See   for
     a list of interrupts that can be returned by a hardware dev-
     ice.


     For  PCI  devices  that  support  MSI  and/or  MSI-X   based
     hardware,  this  interface  returns only the interrupt types
     that are supported by all the hardware in the  path  to  the
     hardware device.


     An interrupt type is usable by the hardware device if it  is
     returned by the ddiintrgetsupportedtypes() function. The
     device driver can be programmed to use one of  the  returned
     interrupt types to receive hardware interrupts.

RETURN VALUES
     The ddiintrgetsupportedtypes() function returns:

     DISUCES          On success.


     DIEINVAL           On encountering invalid  input  parame-
                          ters.



SunOS 5.11          Last change: 07 Apr 2005                    1






Kernel Functions for Drivers     ddiintrgetsupportedtypes(9F)



     DINTRNOTFOUND    Returned when the  hardware  device  is
                          found   not  to  support  any  hardware
                          interrupts.


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

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    


SEE ALSO
     pci(4),      attributes(5),      pcmcia(7D),      sysbus(4),
     ddiintraddhandler(9F),                ddiintralloc(9F),
     ddiintrenable(9F)


     Writing Device Drivers

NOTES
     The ddiintrgetsupportedtypes() function can be called by
     the  device  driver even at any time if the driver has added
     an interrupt handler for a given interrupt type.


     Soft interrupts are always usable and are  not  returned  by
     this interface.


     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: 07 Apr 2005                    2