Kernel Functions for Drivers            ddidmaunbindhandle(9F)



NAME
     ddidmaunbindhandle - unbinds the address in a DMA handle

SYNOPSIS
     #include 
     #include 



     int ddidmaunbindhandle(ddidmahandlet handle);


PARAMETERS
     handle     The  DMA handle previously allocated by a call to
                ddidmaallochandle(9F).


INTERFACE LEVEL
     Solaris DI specific (Solaris DI).

DESCRIPTION
     ddidmaunbindhandle() frees all  DMA resources  associated
     with  an  existing   DMA  handle.  When a  DMA transfer com-
     pletes, the driver should  call  ddidmaunbindhandle()  to
     free   system   DMA  resources  established  by  a  call  to
     ddidmabufbindhandle(9F)                               or
     ddidmaaddrbindhandle(9F).  ddidmaunbindhandle()  does
     an implicit ddidmasync(9F) making further  synchronization
     steps unnecessary.

RETURN VALUES
     DISUCES     on success


     DIFAILURE     on failure


CONTEXT
     ddidmaunbindhandle() can be called from user, kernel,  or
     interrupt context.

SEE ALSO
     ddidmaaddrbindhandle(9F),      ddidmaallochandle(9F),
     ddidmabufbindhandle(9F),        ddidmafreehandle(9F),
     ddidmasync(9F)


     Writing Device Drivers







SunOS 5.11          Last change: 26 Sep 1994                    1