PEXGetOCCValues- Retrieve the Values in an OC Context


Synopsis

 
   void PEXGetOCCValues(
        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 in the PEXOCCValues data structure the function should return to the caller.

values
The address of the PEXOCCValues data structure where you want the function to place the requested values.

Returns

None.

Description

Invoke PEXGetOCCValues to get the values from a PEX OC Context.

If the mask contains all zero bits, then this function does not return any values nor does it alter any members of the values argument. Otherwise, for each defined bit that is one, this function copies the corresponding value from the context to the corresponding member in the values argument. All other members of the values structure are not altered by this function.

Build the mask with the PEXSetOCCValueMask function.

Errors

This function ignores any undefined bits in the mask field.

See Also

For an overview, see Bitmask/Value Interface.