Kernel Functions for Drivers                     ddidmahtoc(9F)



NAME
     ddidmahtoc - convert a DMA handle to a DMA address cookie

SYNOPSIS
     #include 
     #include 
     #include 



     int ddidmahtoc(ddidmahandlet handle, offt off,
          ddidmacookiet *cookiep);


INTERFACE LEVEL
     This interface is obsolete. ddidmaaddrbindhandle(9F)  or
     ddidmabufbindhandle(9F) should be used instead.

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


     off        An offset into the object that handle maps.


     cookiep    A pointer to a ddidmacookie(9S) structure.


DESCRIPTION
     The ddidmahtoc() function takes a DMA handle  (established
     by ddidmasetup(9F)), and fills in the cookie pointed to by
     cookiep with the appropriate address, length, and  bus  type
     to be used to program the DMA engine.

RETURN VALUES
     The ddidmahtoc() function returns:

     DISUCES    Successfully filled in the cookie pointed  to
                    by cookiep.


     DIFAILURE    Failed to successfully fill in the cookie.


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

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



SunOS 5.11          Last change: 16 Jan 2006                    1






Kernel Functions for Drivers                     ddidmahtoc(9F)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Stability Level              Obsolete                    
    


SEE ALSO
     attributes(5),                 ddidmaaddrbindhandle(9F),
     ddidmaaddrsetup(9F),         ddidmabufbindhandle(9F),
     ddidmabufsetup(9F), ddidmasetup(9F),  ddidmasync(9F),
     ddidmacookie(9S)


     Writing Device Drivers








































SunOS 5.11          Last change: 16 Jan 2006                    2