DDI_DMA_UNBIND_HANDLE(9F) Kernel Functions for Drivers


NAME


ddi_dma_unbind_handle - unbinds the address in a DMA handle

SYNOPSIS


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


int ddi_dma_unbind_handle(ddi_dma_handle_t handle);


PARAMETERS


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


INTERFACE LEVEL


Solaris DDI specific (Solaris DDI).

DESCRIPTION


ddi_dma_unbind_handle() frees all DMA resources associated with an
existing DMA handle. When a DMA transfer completes, the driver should
call ddi_dma_unbind_handle() to free system DMA resources established by
a call to ddi_dma_buf_bind_handle(9F) or ddi_dma_addr_bind_handle(9F).
ddi_dma_unbind_handle() does an implicit ddi_dma_sync(9F) making further
synchronization steps unnecessary.

RETURN VALUES


DDI_SUCCESS
on success


DDI_FAILURE
on failure


CONTEXT


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

SEE ALSO


ddi_dma_addr_bind_handle(9F), ddi_dma_alloc_handle(9F),
ddi_dma_buf_bind_handle(9F), ddi_dma_free_handle(9F), ddi_dma_sync(9F)


Writing Device Drivers


September 26, 1994 DDI_DMA_UNBIND_HANDLE(9F)