.\" @(#)PEXSetWorkstationBufferMode.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetWorkstationBufferMode 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetWorkstationBufferMode - Set Workstation Buffer Mode
.SH SYNTAX
.HP
void PEXSetWorkstationBufferMode\^(\^Display *\fIdisplay\fP\^, PEXWorkstation \fIworkstation\fP\^, int \fIbuffer_mode\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIworkstation\fP 1i
The resource identifier of the workstation.
.IP \fIbuffer_mode\fP 1i
The workstation buffering mode (
.B PEXSingleBuffer
or
.B PEXDoubleBuffer
).
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSetWorkstationBufferMode
.LP
This function sets the requested buffer mode of the specified
.I workstation.
If the workstation's display surface attribute is
.B PEXEmpty,
or if the dynamic modification for buffer mode is
.B PEXIMM,
the current buffer mode is set to the specified buffer mode and the buffer
update is set to
.B PEXNotPending;
otherwise, the buffer update is set to
.B PEXPending
and the current buffer mode is not changed.
.LP
Buffer mode may be one of the following values:
.B PEXSingleBuffer
or
.B PEXDoubleBuffer.
An error will be generated if the buffer mode is
.B PEXDoubleBuffer
and the server cannot allocated the second image buffer.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXWorkstation;
.sp
.fi
.SH ERRORS
.TP
.SB BadAlloc
The server failed to allocate resources needed for double-buffering.
.TP
.SB BadPEXWorkstation
The specified workstation resource identifier is invalid.
.TP
.SB BadValue
The specified buffer mode is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXSetWorkstationDisplayUpdateMode (3)
.BR PEXGetImpDepConstants (3)
.fi