Kernel Functions for Drivers                     ddidmacoff(9F)



NAME
     ddidmacoff - convert a DMA cookie to an  offset  within  a
     DMA handle.

SYNOPSIS
     #include 
     #include 
     #include 



     int ddidmacoff(ddidmahandlet handle, ddidmacookiet *cookiep,
          offt *offp);


INTERFACE LEVEL
     Solaris SPARC DI (Solaris SPARC  DI).  This  interface  is
     obsolete.

PARAMETERS
     handle     The   handle   filled   in   by   a    call    to
                ddidmasetup(9F).


     cookiep    A    pointer    to    a    DMA    cookie     (see
                ddidmacookie(9S)) that contains the appropriate
                address, length and bus type to be used  in  pro-
                gramming the DMA engine.


     offp       A pointer to an offset to be filled in.


DESCRIPTION
     The ddidmacoff()  function  converts  the  values  in  DMA
     cookie  pointed  to  by cookiep to an offset (in bytes) from
     the beginning of the object that the DMAhandle has mapped.


     The ddidmacoff() function allows a driver to update a  DMA
     cookie  with  values  it  reads from its device's DMA engine
     after a transfer completes and convert that  value  into  an
     offset into the object that is mapped for DMA.

RETURN VALUES
     The ddidmacoff() function returns:

     DISUCES    Successfully filled in offp.


     DIFAILURE    Failed to successfully fill in offp.




SunOS 5.11          Last change: 16 Jan 2006                    1






Kernel Functions for Drivers                     ddidmacoff(9F)



CONTEXT
     The ddidmacoff() function can be called from user,  inter-
     rupt, or kernel context.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Obsolete                    
    


SEE ALSO
     ddidmasetup(9F), ddidmasync(9F), ddidmacookie(9S)


     Writing Device Drivers

































SunOS 5.11          Last change: 16 Jan 2006                    2