Name

pclose_ws − Specifies the workstation identifier of the workstation to be closed. 

Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function

Syntax

void pclose_ws (
  Pint    wsid     /∗ (I) Workstation identifier ∗/
)

Description

pclose_ws specifies the workstation identifier of the workstation to be closed.  This function causes the following actions to occur:

•Digital PHIGS performs an implicit pupd_ws function operation (with the regeneration flag set to PFLAG_PERFORM) on the specified workstation. 

•Digital PHIGS releases the workstation state list. 

•Digital PHIGS deletes the specified workstation from the set of open workstations in the PHIGS state list. See the popen_ws function for more information. 

•Digital PHIGS deletes the specified workstation from the list of posted workstations in the structure state list. 

•Digital PHIGS flushes the input queue. 

•If the PHIGS error state list entry identification of one of the logical input devices that caused an input queue overflow references the specified workstation, all of the contents of that entry become undefined. 

•Digital PHIGS makes the workstation description table unavailable, and the workstation type value associated with this description table becomes undefined. 

•Digital PHIGS releases the connection to the specified workstation. 

•Digital PHIGS sets the workstation state to WSCL, if no workstations are open. 

•Digital PHIGS clears the display surface of the specified workstation, if the display surface empty entry in the workstation state list is NOTEMPTY. 

See Also

popen_ws
pupd_ws