ComRead
value ComRead ( value hCom, string/array BYREF Result, value Count = -1, value TimeoutInMilliSeconds = 0 );
Rückgabewert
Bei Erfolg ist der Rückgabewert die Anzahl der Zeichen, die von der Schnittstelle ausgelesen wurden. Wird der Wert 0 zurückgegeben, so wurde vor Aufruf der Funktion ComRead bzw. innerhalb der TimeoutInMilliSeconds Zeit kein Zeichen empfangen. -1 wird zurück geliefert, wenn das Schnittstellenobjekt hCom ungültig ist.
Parameter
hCom
Das Schnittstellenobjekt der geöffneten seriellen Schnittstelle, von dem Daten gelesen werden soll.
Result
Die Zeichenkette, die von der seriellen Schnittstelle gelesen wurden.
Count
Die maximale Anzahl der Zeichen die von der seriellen Schnittstelle zu lesen sind.
Count < 0 Alle Zeichen auslesen, die von der seriellen Schnittstelle vor Aufruf dieser Funktion empfangen wurden und innerhalb der TimeoutInMilliSeconds Zeit empfangen werden. Bei TimeoutInMilliSeconds == 0 werden nur die Zeichen zurückgegeben, die bisher von der seriellen Schnittstelle empfangen wurden.
Count > 0 Maximal die Anzahl Count von Zeichen auslesen, , die von der seriellen Schnittstelle vor Aufruf dieser Funktion empfangen wurden und innerhalb der TimeoutInMilliSeconds Zeit empfangen werden. Wurden mehr Zeichen empfangen, so werden diese zwischengespeichert.
TimeoutInMilliSeconds
Die maximale Zeit in der auf empfangene Zeichen der seriellen Schnittstelle gewartet wird.
TimeoutInMilliSeconds == 0 Es wird nicht auf Zeichen gewartet, sondern es werden nur die Zeichen die bisher empfangen wurden ausgelesen.
TimeoutInMilliSeconds > 0 Maximale Wartezeit in Millisekunden die zusätzlich verwendet werden kann, um auf Zeichen zu warten die bisher noch nicht empfangen wurden. Diese Funktion benötigt somit maximal diese Zeit bis sie wieder zurückkehrt, außer es wurden die Anzahl Count von Zeichen vor Ablauf dieser Zeit gelesen.
Bemerkungen
Liest eine Anzahl Zeichen von der geöffneten Schnittstellenobjekt hCom. Wurden mehr Zeichen empfangen als ausgelesen werden, gehen die zuviel empfangenen Zeichen nicht verloren.
Beispiel
value hCom; //muß eine geöffnete Schnittstelle sein (ComOpen)
string strData;
//Lese alle bisher empfangen Zeichen der Schnittstelle COM1: aus
ComRead (hCom, strData);
Siehe auch ComWaitForString, ComWrite