`TraceMgrRecordUpdate4` (FUN)

FUNCTION TraceMgrRecordUpdate4 : RTS_IEC_RESULT

Stores multiple values with seperate timestamps in the ring buffer of a trace record.

This function can be used to provide the data for so called system parameters from the IEC application. (See TRACE_VAR_ADDRESS_FLAGS_SYSTEM.)

Note

in contrast to TraceMgrRecordUpdate2, the timestamp of the values and the values itself are provided in seperate lists by the caller.

Note

the number of timestamps must be the same as the number of data values. ulEntries must match to this number.

InOut:

Scope	Name	Type	Comment
Return	`TraceMgrRecordUpdate4`	`RTS_IEC_RESULT`	Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket or hPrevRecord is not a valid handle ERR_NOTINITIALIZED if the packet is not currently recording (not started, trigger reached, …) ERR_PENDING if no value is recorded for this cycle due to TracePacketConfiguration.ulEveryNCycles
Input	`hPacket`	`RTS_IEC_HANDLE`	The trace packet handle
	`hRecord`	`RTS_IEC_HANDLE`	The trace record handle
	`pTimestamps`	POINTER TO UDINT	The address of the first timestamp of the variable values
	`pDataValues`	POINTER TO BYTE	The address of the first variable value of the list to copy
	`ulEntries`	`UDINT`	The number of variables to be updated

TraceMgrRecordUpdate4 (FUN)