PEXChangeOCC - Change the Values in an OC Context

Synopsis

 
   void PEXChangeOCC(
        PEXOCC context,
        unsigned long *mask,
        PEXOCCValues *values
)

Arguments

context
A PEXOCC returned by a successful PEXCreateOCC call.

mask
A pointer to an array of one unsigned long indicating which values provided in the PEXOCCValues data structure are to be used to modify the specified OC Context.

values
The address of the PEXOCCValues data structure containing the values to be used to modify the OC Context.

Returns

None

Description

Invoke PEXChangeOCC to modify the values in a PEX OC Context.

If the mask contains all zero bits, then this function does not make any changes. Otherwise, for each defined bit that is one, this function copies the corresponding value from the values argument to the context.

Build the mask with the PEXSetOCCValueMask function.

Errors

This function ignores any undefined bits in the mask field.

Errors in setting the OC Context will not be apparent until the application actually uses the OCC as an argument in an OC function invocation.

See Also

For an overview, see Bitmask/Value Interface.