Manual page for ddi_dma_unbind_handle(9F)
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);
ARGUMENTS
- 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_dma_unbind_handle()
returns:
-
- 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_free_handle.9f
Created by unroff & hp-tools.
© by Hans-Peter Bischof. All Rights Reserved (1997).
Last modified 21/April/97