PEXGetPipelineContext5_2 - Get Pipeline Context Attributes (5.0)


Synopsis

 
   PEXPCAttributes5_2 *PEXGetPipelineContext5_2(
        Display *display,
        PEXPipelineContext context,
        unsigned long *value_mask
   )
 

 
   PEXPCAttributes *PEXGetPipelineContext(
        Display *display,
        PEXPipelineContext context,
        unsigned long *value_mask
   )
 

Arguments

display
A pointer to a display structure returned by a successful XOpenDisplay call.

context
The resource identifier of the pipeline context.
value_mask
A pointer to an array of three unsigned long.

Returns

A pointer to pipeline context values; a null pointer if unsuccessful.

Description

Invoke PEXGetPipelineContext5_2 to obtain the requested attribute values of the pipeline context. You must use the 5.2 form of the function unless all aspects of the components you wish to get were defined in PEX 5.0 or 5.1. Note that each of the two forms uses a different structure for the returned parameter.

Use the value_mask to indicate which attribute values you are requesting. Invoke the PEXSetPCAttributeMask and PEXSetPCAttributeMaskAll functions to set up the value_mask.

PEXlib allocates the memory for the return value. Invoke the PEXFreePCAttributes5_2 (or PEXFreePCAttributes as appropriate) function to deallocate the memory.

Errors

BadPEXPipelineContext
The specified pipeline context resource identifier is invalid.

BadValue
An invalid bit is set in the value mask.

See Also

For related topics and for a list of pipeline context functions, see Pipeline Contexts.