1ddi_dma_unbind_handle(9F)Kernel Functions for Driversddi_dma_unbind_handle(9F)
2
3
4

NAME

6       ddi_dma_unbind_handle - unbinds the address in a DMA handle
7

SYNOPSIS

9       #include <sys/ddi.h>
10       #include <sys/sunddi.h>
11
12
13
14       int ddi_dma_unbind_handle(ddi_dma_handle_t handle);
15
16

PARAMETERS

18       handle     The    DMA   handle   previously  allocated  by  a  call  to
19                  ddi_dma_alloc_handle(9F).
20
21

INTERFACE LEVEL

23       Solaris DDI specific (Solaris DDI).
24

DESCRIPTION

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

RETURN VALUES

34       DDI_SUCCESS     on success
35
36
37       DDI_FAILURE     on failure
38
39

CONTEXT

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

SEE ALSO

45       ddi_dma_addr_bind_handle(9F),                 ddi_dma_alloc_handle(9F),
46       ddi_dma_buf_bind_handle(9F), ddi_dma_free_handle(9F), ddi_dma_sync(9F)
47
48
49       Writing Device Drivers
50
51
52
53SunOS 5.11                        26 Sep 1994        ddi_dma_unbind_handle(9F)