Kernel Functions for Drivers csx_ModifyWindow(9F)
NAME
csx_ModifyWindow - modify window attributes
SYNOPSIS
#include
int32_t csx_ModifyWindow(window_handle_t wh, modify_win_t *mw);
INTERFACE LEVEL
Solaris DDI Specific (Solaris DDI)PARAMETERS
wh Window handle returned from csx_RequestWindow(9F).
mw Pointer to a modify_win_t structure.
DESCRIPTION
This function modifies the attributes of a window allocatedby the csx_RequestWindow(9F) function.
Only some of the window attributes or the access speed fieldmay be modified by this request. The csx_MapMemPage(9F)
function is also used to set the offset into PC Card memory to be mapped into system memory for paged windows. Thecsx_RequestWindow(9F) and csx_ReleaseWindow(9F) functions
must be used to change the window base or size. STRUCTURE MEMBERSThe structure members of modify_win_t are:
uint32_t Attributes; /* window flags */
uint32_t AccessSpeed; /* window access speed */
The fields are defined as follows:Attributes This field is bit-mapped and defined as fol-
lows:WIN_MEMORY_TYPE_CM 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 csx_ModifyWindow(9F)
WIN_MEMORY_TYPE_AM Window points to
Attribute Memory area. Set this to map the window to Attribute Memory.WIN_ENABLE Enable Window. The
client must set this to enable the window.WIN_ACCESS_SPEED_VALID 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 theformat 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 nsec5 - 7 Reserved: do not use
It is recommended that clients use thecsx_ConvertSpeed(9F) function to generate the
appropriate AccessSpeed values rather thanSunOS 5.11 Last change: 19 Jul 1996 2
Kernel Functions for Drivers csx_ModifyWindow(9F)
manually perturbing the AccessSpeed field.RETURN VALUES
CS_SUCCESS Successful operation.
CS_BAD_HANDLE Window handle is invalid.
CS_NO_CARD No PC Card in socket.
CS_BAD_OFFSET Error getting/setting window
hardware parameters.CS_BAD_WINDOW Error getting/setting window
hardware parameters.CS_BAD_SPEED AccessSpeed is invalid.
CS_UNSUPPORTED_FUNCTION No PCMCIA hardware installed.
CONTEXT
This function may be called from user or kernel context.SEE ALSO
csx_ConvertSpeed(9F), csx_MapMemPage(9F),
csx_ReleaseWindow(9F), csx_RequestWindow(9F)
PC Card 95 Standard, PCMCIA/JEIDA
SunOS 5.11 Last change: 19 Jul 1996 3