|
<< Click to Display Table of Contents >> Navigation: MscDll Referenzhandbuch > Programmierschnittstelle > Verbindung > MSC_Start |
Diese Funktion startet den Datentransfer.
Definition
MSC_STATUS
MSC_Start(
MSC_HANDLE Handle,
unsigned long SndPeriod,
unsigned long DisconnectTimeout,
unsigned long RetryCount,
unsigned long ResponseTimeout
);
Parameter
Handle
Handle zu dem Gerät (Irinos-System), das bei einem früheren Aufruf der Funktion MSC_OpenDevice zurückgegeben wurde.
SndPeriod
[ms] Abstand zwischen zwei UDP-Telegrammen, die an das Gerät gesendet werden. Falls die Dauer geringer ist, als die Zeit, die benötigt wird, um eine Antwort vom Gerät zu erhalten, wird das nächste Telegramm sobald wie möglich gesendet.
DisconnectTimeout
[ms] Falls in diesem Zeitintervall keine Antwort vom Gerät (Irinos-System) empfangen wurde, wird die Geräte-Benachrichtigung gesetzt.
RetryCount
Anzahl an Telegrammwiederholungen, bevor ein Fehler festgestellt wird.
ResponseTimeout
[ms] Zeitintervall, nach dem ein Telegramm bei ausbleibender Antwort wiederholt wird.
Rückgabewert
Die Funktion gibt im Erfolgsfall MSC_STATUS_SUCCESS zurück, bei Fehlern wird der Fehlercode zurückgegeben.
Kommentare
Der Datentransfer muss über diese Funktion gestartet werden, bevor irgendeine Art der Kommunikation stattfinden kann.
Beispielwerte
Folgende Beispielwerte sind für statische Messungen sowie für die meisten dynamischen Messungen sehr gut geeignet:
SndPeriod = 1
DisconnectTimeout = 500
RetryCount = 10
ResponseTimeout = 75
Um eine möglichst kurze Sende-Periode zu erreichen, muss unter Windows ein Multimedia-Timer mit 1ms gestartet werden. Dieser setzt die Windows-Tick-Time vom Standardwert (15,6ms) auf ≤ 1ms herab. Es wird empfohlen diesen Multimedia-Timer in die Applikation zu integrieren.
Alle Beispielwerte beziehen sich auf eine direkte Ethernet-Verbindung zwischen PC und Irinos-System.
Siehe auch