1ddi_dma_curwin(9F) Kernel Functions for Drivers ddi_dma_curwin(9F)
2
3
4
6 ddi_dma_curwin - report current DMA window offset and size
7
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
19 This interface is obsolete. ddi_dma_getwin(9F) should be used instead.
20
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
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
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
52 The ddi_dma_curwin() function can be called from user, interrupt, or
53 kernel context.
54
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
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)