csx_ModifyWindow(9f)

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

NAME

6       csx_ModifyWindow - modify window attributes
7

SYNOPSIS

9       #include <sys/pccard.h>
10
11
12
13       int32_t csx_ModifyWindow(window_handle_t wh, modify_win_t *mw);
14
15

INTERFACE LEVEL

17       Solaris DDI Specific (Solaris DDI)
18

PARAMETERS

20       wh     Window handle returned from csx_RequestWindow(9F).
21
22
23       mw     Pointer to a modify_win_t structure.
24
25

DESCRIPTION

27       This  function  modifies  the  attributes  of a window allocated by the
28       csx_RequestWindow(9F) function.
29
30
31       Only some of the window attributes or the access  speed  field  may  be
32       modified  by this request. The csx_MapMemPage(9F) function is also used
33       to set the offset into PC Card memory to be mapped into  system  memory
34       for  paged windows. The csx_RequestWindow(9F) and csx_ReleaseWindow(9F)
35       functions must be used to change the window base or size.
36

STRUCTURE MEMBERS

38       The structure members of modify_win_t are:
39
40         uint32_t       Attributes;          /* window flags */
41         uint32_t       AccessSpeed;         /* window access speed */
42
43
44
45       The fields are defined as follows:
46
47       Attributes     This field is bit-mapped and defined as follows:
48
49                      WIN_MEMORY_TYPE_CM        Window points to Common Memory
50                                                area. Set this to map the win‐
51                                                dow to Common Memory.
52
53
54                      WIN_MEMORY_TYPE_AM        Window  points  to   Attribute
55                                                Memory  area.  Set this to map
56                                                the window to  Attribute  Mem‐
57                                                ory.
58
59
60                      WIN_ENABLE                Enable Window. The client must
61                                                set this to enable the window.
62
63
64                      WIN_ACCESS_SPEED_VALID    AccessSpeed valid. The  client
65                                                must   set   this   when   the
66                                                AccessSpeed field has a  value
67                                                that  the client wants set for
68                                                the window.
69
70
71
72       AccessSpeed    The bit definitions for this field use the format of the
73                      extended  speed byte of the Device ID tuple. If the man‐
74                      tissa is 0 (noted as reserved in the PC  Card  95  Stan‐
75                      dard),  the  lower bits are a binary code representing a
76                      speed from the list below. Numbers in the  first  column
77                      are codes; items in the second column are speeds.
78
79                      0        Reserved: do not use
80
81
82                      1        250 nsec
83
84
85                      2        200 nsec
86
87
88                      3        150 nsec
89
90
91                      4        100 nsec
92
93
94                      5 - 7    Reserved: do not use
95
96                      It  is  recommended  that  clients  use the csx_Convert‐
97                      Speed(9F)   function   to   generate   the   appropriate
98                      AccessSpeed  values  rather than manually perturbing the
99                      AccessSpeed field.
100
101

RETURN VALUES

103       CS_SUCCESS                  Successful operation.
104
105
106       CS_BAD_HANDLE               Window handle is invalid.
107
108
109       CS_NO_CARD                  No PC Card in socket.
110
111
112       CS_BAD_OFFSET               Error   getting/setting   window   hardware
113                                   parameters.
114
115
116       CS_BAD_WINDOW               Error   getting/setting   window   hardware
117                                   parameters.
118
119
120       CS_BAD_SPEED                AccessSpeed is invalid.
121
122
123       CS_UNSUPPORTED_FUNCTION     No PCMCIA hardware installed.
124
125

CONTEXT

127       This function may be called from user or kernel context.
128