.\" @(#)PEXCopyPipelineContext.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXCopyPipelineContext 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXCopyPipelineContext \- Copy Pipeline Context
.SH SYNTAX
.LP
.IP void .4i
PEXCopyPipelineContext\^(\^Display *\fIdisplay\fP\^, unsigned long *\fIvalue_mask\fP\^, PEXPipelineContext \fIsrc_context\fP\^, PEXPipelineContext \fIdst_context\fP\^)
.SH PARAMETERS
.TP 1i
\fIdisplay\fP
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.TP
\fIvalue_mask\fP
A pointer to an array of three unsigned long.
.TP
\fIsrc_context\fP
The resource identifier of the source pipeline.
.TP
\fIdst_context\fP
The resource identifier of the destination pipeline context.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXCopyPipelineContext
.IX "Copy" "PEXCopyPipelineContext"
.IX "Pipeline Context" PEXCopyPipelineContext
.LP
This function copies attributes from the source pipeline context
to the destination pipeline context.  Both must
already exist as valid pipeline context resources.  Only the attributes
indicated by the value mask are copied and
the remainder of the attributes are left as they were.
.BR PEXSetPCAttributeMask (3)
and
.BR PEXSetPCAttributeMaskAll (3)
can be called to setup the value mask.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID    PEXPipelineContext;
.sp
.fi
.SH ERRORS
.TP
.SB BadPEXPipelineContext
A specified pipeline context resource identifier is invalid.
.TP
.SB BadValue
An invalid bit is set in the value mask.
.SH SEE ALSO
.LP
.nf
.BR PEXCreatePipelineContext (3)
.BR PEXSetPCAttributeMask (3)
.fi