.\" @(#)PEXGetPipelineContext.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXGetPipelineContext 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXGetPipelineContext - Get Pipeline Context Attributes
.SH SYNTAX
.HP
PEXPCAttributes *PEXGetPipelineContext\^(\^Display *\fIdisplay\fP\^, PEXPipelineContext \fIcontext\fP\^, unsigned long *\fIvalue_mask\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIcontext\fP 1i
The resource identifier of the pipeline context.
.IP \fIvalue_mask\fP 1i
A pointer to an array of three unsigned long.
.SH RETURNS
.LP
A pointer to pipeline context values; a null pointer if unsuccessful.
.SH DESCRIPTION
.\" indexing
.IX PEXGetPipelineContext
.IX "Pipeline Context" PEXGetPipelineContext
.LP
This function returns the requested attribute values of the pipeline context.
The value mask indicates which attribute values are requested.
.B PEXSetPCAttributeMask
and
.B PEXSetPCAttributeMaskAll
can be called to setup the value mask.
PEXlib allocates the memory for the return value.
.BR PEXFreePCAttributes (3)
should be called to deallocate the memory.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXPipelineContext;
.fi
.sp .5
See also
.B PEXlib.h.
.SH ERRORS
.TP
.SB BadPEXPipelineContext
The 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 PEXChangePipelineContext (3)
.fi