1ddi_dma_curwin(9F)       Kernel Functions for Drivers       ddi_dma_curwin(9F)
2
3
4

NAME

6       ddi_dma_curwin - report current DMA window offset and size
7

SYNOPSIS

9       #include <sys/conf.h>
10       #include <sys/ddi.h>
11       #include <sys/sunddi.h>
12
13
14
15       int ddi_dma_curwin(ddi_dma_handle_t handle, off_t *offp, uint_t *lenp);
16
17

INTERFACE LEVEL

19       This interface is obsolete. ddi_dma_getwin(9F) should be used instead.
20

PARAMETERS

22       handle    The DMA handle filled in by a call to ddi_dma_setup(9F).
23
24
25       offp      A pointer to a value which will be filled in with the current
26                 offset from the beginning of the object that  is  mapped  for
27                 DMA.
28
29
30       lenp      A  pointer  to a value which will be filled in with the size,
31                 in bytes, of the current  window  onto  the  object  that  is
32                 mapped for DMA.
33
34

DESCRIPTION

36       The ddi_dma_curwin() function reports the current DMA window offset and
37       size. If  a  DMA  mapping  allows  partial  mapping,  that  is  if  the
38       DDI_DMA_PARTIAL  flag in the ddi_dma_req(9S) structure is set, its cur‐
39       rent (effective) DMA window offset and size can be obtained by  a  call
40       to ddi_dma_curwin().
41

RETURN VALUES

43       The ddi_dma_curwin() function returns:
44
45       DDI_SUCCESS    The current length and offset can be established.
46
47
48       DDI_FAILURE    Otherwise.
49
50

CONTEXT

52       The  ddi_dma_curwin()  function  can be called from user, interrupt, or
53       kernel context.
54

ATTRIBUTES

56       See attributes(5) for a description of the following attributes:
57
58
59
60
61       ┌─────────────────────────────┬─────────────────────────────┐
62       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
63       ├─────────────────────────────┼─────────────────────────────┤
64       │Stability Level              │Obsolete                     │
65       └─────────────────────────────┴─────────────────────────────┘
66

SEE ALSO

68       attributes(5),  ddi_dma_getwin(9F),  ddi_dma_movwin(9F),   ddi_dma_set‐
69       up(9F), ddi_dma_req(9S)
70
71
72       Writing Device Drivers
73
74
75
76SunOS 5.11                        16 Jan 2006               ddi_dma_curwin(9F)
Impressum