TraceMgrRecordUpdate (FUN)

FUNCTION TraceMgrRecordUpdate : RTS_IEC_RESULT

Records the current value of the trace variable of a record together with the current time stamp.

Note

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

InOut:

Scope

Name

Type

Comment

Return

TraceMgrRecordUpdate

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