TraceMgrRecordUpdate5 (FUN)

FUNCTION TraceMgrRecordUpdate5 : RTS_IEC_RESULT

Records the current value of the trace variable of a record. For all trace records in the context of an IEC or system task, we use one timestamp for all values [CDS-66118].

Note

This function is called cyclically by CmpTraceMgr. It should not be called by the application.

InOut:

Scope

Name

Type

Comment

Return

TraceMgrRecordUpdate5

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

  • ERR_FAILED if reading the value of the trace variable failed

Input

hPacket

RTS_IEC_HANDLE

The trace packet handle

hRecord

RTS_IEC_HANDLE

The trace record handle

pstTimestamp

POINTER TO SYSTIME

The address of the timestamp of the variable values