Werbung
C++ API
13 C++ API
13.1
Datentypen
13.1.1
TcMark16
Datentyp, der eine Marke repräsentiert.
typedef struct {
USHORT ContextId;
USHORT GroupId;
USHORT EventId;
} TcMark16;
Beschreibung:
Mithilfe dieses Datentyps ist es möglich, eine generische Marke (noch ohne deren Typ) zu definieren.
ContextId: Mithilfe der ContextId können Markengruppen, also darzustellende Prozesse, gruppiert werden
(z. B. nach Prozessart oder Funktionseinheit).
GroupId: Definiert den darzustellenden Prozess / das darzustellende Prozessereignis.
EventId: Optionales Anwenderdatum. Es kann verwendet werden, um z. B. den Zustand einer Statemachine
oder Errorcodes im TwinCAT 3 Realtime Monitor darzustellen.
Sowohl die ContextId als auch die GroupId können im TwinCAT 3 Realtime Monitor mit Namen
versehen werden. Diese können über die Funktionen User Contexts [} 40] bzw. User Contexts [} 40]
exportiert bzw. importiert werden, so dass sie auch für die weitere Aufzeichnung zur Verfügung
stehen.
13.2
Klassen
13.2.1
CTcLogMark
CTcLogMark(USHORT nContextId, ITComObjectServer* ipSrv = NULL);
Beschreibung:
Die Klasse CTcLogMark ist eine C++-Klasse, die es ermöglicht, (Zeit-)Marken aus C++-Applikationscode
heraus so zu setzen, dass diese mit dem TwinCAT 3 Realtime Monitor dargestellt werden können.
13.2.1.1
LogIntervalStart
virtual HRESULT LogIntervalStart(USHORT GroupId, USHORT EventId);
Beschreibung:
Die Methode erstellt eine Marke mit einem Intervallstart für die übergebene Marken-ID.
Parameter:
GroupId: Marken-ID (Markengruppe) für die die Marke geschrieben werden soll.
EventId: Optionale Event-ID.
58
Version: 2.0.0
TE1010
Werbung
