te
 Copyright (c) 2000, Sun Microsystems, Inc.
 All Rights Reserved
 The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
 You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
 When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
 CSX_MODIFYWINDOW 9F "Jul 19, 1996"
 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
illumos DDI Specific (illumos 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_ReleaseWindow(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
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