csx_ModifyWindow(9F)					   Kernel Functions for Drivers 				      csx_ModifyWindow(9F)

NAME

       csx_ModifyWindow - modify window attributes

SYNOPSIS

       #include <sys/pccard.h>

       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 allocated by the csx_RequestWindow(9F) function.

       Only  some of the window attributes or the access speed field may 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.   The  csx_RequestWindow(9F)  and  csx_ReleaseWin-
       dow(9F) functions must be used to change the window base or size.

STRUCTURE MEMBERS

       The 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 follows:

		       WIN_MEMORY_TYPE_CM

			   Window points to Common Memory area. Set this to map the window to Common Memory.

		       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 the format of the extended speed byte of the Device 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 csx_ConvertSpeed(9F) function to generate the appropriate AccessSpeed values  rather
		       than manually perturbing the AccessSpeed field.

RETURN VALUES

       "small and bold">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.10							    19 Jul 1996 					      csx_ModifyWindow(9F)