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
illumos DDI specific (illumos 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)