Kernel Functions for Drivers csxModifyWindow(9F)
NAME
csxModifyWindow - modify window attributes
SYNOPSIS
#include
int32t csxModifyWindow(windowhandlet wh, modifywint *mw);
INTERFACE LEVEL
Solaris DI Specific (Solaris DI)
PARAMETERS
wh Window handle returned from csxRequestWindow(9F).
mw Pointer to a modifywint structure.
DESCRIPTION
This function modifies the attributes of a window allocated
by the csxRequestWindow(9F) function.
Only some of the window attributes or the access speed field
may be modified by this request. The csxMapMemPage(9F)
function is also used to set the offset into PC Card memory
to be mapped into system memory for paged windows. The
csxRequestWindow(9F) and csxReleaseWindow(9F) functions
must be used to change the window base or size.
STRUCTURE MEMBERS
The structure members of modifywint are:
uint32t Attributes; /* window flags */
uint32t AccessSpeed; /* window access speed */
The fields are defined as follows:
Attributes This field is bit-mapped and defined as fol-
lows:
WINMEMORYTYPECM Window points to
Common Memory area.
Set this to map the
window to Common
Memory.
SunOS 5.11 Last change: 19 Jul 1996 1
Kernel Functions for Drivers csxModifyWindow(9F)
WINMEMORYTYPEAM Window points to
Attribute Memory
area. Set this to
map the window to
Attribute Memory.
WINENABLE Enable Window. The
client must set
this to enable the
window.
WINACESPEDVALID AccessSpeed valid.
The client must set
this when the
AccessSpeed field
has a value that
the client wants
set for the window.
AccessSpeed The bit definitions for this field use the
format of the extended speed byte of the Dev-
ice ID tuple. If the mantissa is 0 (noted as
reserved in the PC Card 95 Standard), the
lower bits are a binary code representing a
speed from the list below. Numbers in the
first column are codes; items in the second
column are speeds.
0 Reserved: do not use
1 250 nsec
2 200 nsec
3 150 nsec
4 100 nsec
5 - 7 Reserved: do not use
It is recommended that clients use the
csxConvertSpeed(9F) function to generate the
appropriate AccessSpeed values rather than
SunOS 5.11 Last change: 19 Jul 1996 2
Kernel Functions for Drivers csxModifyWindow(9F)
manually perturbing the AccessSpeed field.
RETURN VALUES
CSUCES Successful operation.
CSBADHANDLE Window handle is invalid.
CSNOCARD No PC Card in socket.
CSBADOFSET Error getting/setting window
hardware parameters.
CSBADWINDOW Error getting/setting window
hardware parameters.
CSBADSPED AccessSpeed is invalid.
CSUNSUPORTEDFUNCTION No PCMCIA hardware installed.
CONTEXT
This function may be called from user or kernel context.
SEE ALSO
csxConvertSpeed(9F), csxMapMemPage(9F),
csxReleaseWindow(9F), csxRequestWindow(9F)
PC Card 95 Standard, PCMCIA/JEIDA
SunOS 5.11 Last change: 19 Jul 1996 3
|
