piar_timedvalues

This function returns values for the times in the passed array. The values are derived by interpolating between Archive events for resolution codes 1, 2, and 3 and the previous value is used for resolution code 4. The time of the first value is passed in times[0] and succeeding value times in the rest of the times array. The times must be in ascending order.

If there is more than one event at the desired time, the first event in the Archive is the one returned. For points which are not of type real, the value is returned in istats and rvals is meaningless. The number of values to return is passed in count. The prev flag, when used with resolution code 4 tags, indicates the times of the events are to be returned.

C format

int32 piar_timedvalues(

int32 pt,

int32 PIPTR * count,

int32 times[],

float rvals[],

int32 istats[],

int32 prev );

Returns

>0

System error

Success

-1

Bad point number

-105

Bad time stamp

-121

Invalid count parameter

-996

Message too big for PINET protocol

-998

Memory allocation error

Arguments

pt (passed)

Point number

count (passed, returned)

Number of values

times (passed, returned)

Time stamps of values (returned only if the prev flag is true for resolution code 4 tags)

rvals (returned)

Values in engineering units

istats (returned)

Integer or status values

prev (passed)

Previous value flag (if true causes return of actual event times for resolution code 4 points)

Usage Notes

Enabling Operational Intelligence