Werbung
CANSetTime
CANSetTime — Setzt die System-Uhrzeit auf dem AnaGate CAN Gerät für den
Zeitstempel-Modus.
Syntax
#include <AnaGateDllCan.h>
AnaInt32 CANSetTime(AnaInt32 hHandle, AnaUInt32 nSeconds, AnaUInt32
nMicroseconds);
Parameter
hHandle
Gültiges Zugriffs-Handle eines erfolgreichen Aufrufs von CANOpenDevice.
nSeconds Aktuelle Uhrzeit in Sekunden seit dem 01.01.1970.
nMicroseconds
Rückgabewert
Die Funktion gibt im Erfolgsfall Null zurück, andernfalls einen Fehlercode (Anhang A,
Rückgabewerte aus den API-Funktionen ).
Beschreibung
Mit der Funktion CANSetTime kann die System-Uhrzeit auf dem AnaGate-Gerät
voreingestellt werden. Das Anpassen der System-Uhrzeit ist vor allem dann sinnvoll,
falls der Zeitstempel-Modus auf der Verbindung aktiviert ist.
Falls über die Funktion CANSetGlobals der Zeitstempel-Modus eingeschaltet worden
ist, enthalten alle empfangenen CAN-Nachrichten einen zusätzlichen Zeitstempel,
der angibt, zu welchem Zeitpunkt die Nachricht empfangen wurde. Beim Senden
von CAN-Nachrichten wird ein entsprechender Zeitstempel über die Quittung des
Schreibkommandos an den Sender zurück übermittelt, der angibt, zu welchem
Zeitpunkt die Nachricht vom CAN-Controller quittiert wurde (dies nur falls die sog.
Confirmations aus Performance-Gesichtspunkten eingeschaltet sind).
Bemerkung
Die Funktion CANSetTime ist erst ab Version 1.4-1.8 der Laufzeitbibliothek
vorhanden.
Die Uhrzeit-Einstellung für den Zeitstempel-Modus können beim AnaGate CAN
(Hardware-Version 1.1.A) nicht vorgenommen werden. Die Angaben werden vom
Gerät ignoriert.
Siehe auch
CANGetTime
CAN API Funktionen
Zusätzlicher Anteil der Mikrosekunden für die aktuelle Uhrzeit.
24
© 2007-2015 Analytica GmbH
Werbung
Kapitel
