ddi_dma_htoc(9F)

NAME

     ddi_dma_htoc - convert a DMA handle to a DMA address cookie

SYNOPSIS

     #include <sys/conf.h>
     #include <sys/ddi.h>
     #include <sys/sunddi.h>

     int   ddi_dma_htoc(ddi_dma_handle_t   handle,   off_t   off,
     ddi_dma_cookie_t *cookiep);

INTERFACE LEVEL

     This interface is obsolete. ddi_dma_addr_bind_handle(9F)  or
     ddi_dma_buf_bind_handle(9F) should be used instead.

PARAMETERS

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

     off   An offset into the object that handle maps.

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

DESCRIPTION

     ddi_dma_htoc()  takes   a   DMA   handle   (established   by
     ddi_dma_setup(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

     ddi_dma_htoc() returns:

     DDI_SUCCESS
           Successfully filled in the cookie pointed to by  cook-
           iep.

     DDI_FAILURE
           Failed to successfully fill in the cookie.

CONTEXT

     ddi_dma_htoc() can be called from user or interrupt context.

ATTRIBUTES

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

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Stability Level             | Obsolete                    |
    |_____________________________|_____________________________|

SEE ALSO

     attributes(5),                 ddi_dma_addr_bind_handle(9F),
     ddi_dma_addr_setup(9F),         ddi_dma_buf_bind_handle(9F),
     ddi_dma_buf_setup(9F), ddi_dma_setup(9F),  ddi_dma_sync(9F),
     ddi_dma_cookie(9S)

     Writing Device Drivers