CL2.Read (FUN)

 

Diese Funktion der CAA_CanL2.library gibt den Handle der ältesten ungelesenen Meldung in der Warteschlange an die empfangende Struktur zurück. "CL2.LostMessages”* beinhaltet die Anzahl Meldungen, die seit dem letzten Aufruf wegen Überlauf der Wartesch­lange verloren gegangen sind.

Eine mit CL2.Read gelesene Meldung muss immer über CL2.FreeMes­sage bestätigt und freigegeben werden, und kann vorher mit CL2.CloneMessage kopiert werden.

Beachten Sie bitte, dass die Inhalte von „hMessage“ nicht verändert werden dürfen, weil derlei Änderungen die empfangene Meldung (nicht die Kopie) betreffen und folglich auch alle anderen, die die Meldung erhalten, betreffen würde.

Eingang:

hRegId

CAA.HANDLE

Handle von Bezeichner registriert

pctMsgLeft

CAA.COUNT

peError

POINTER TO CL2.ERROR

Zeiger auf Fehlercode (Aufzählungstyp)

Ausgang:

hMessage

CAA.HANDLE

Handle von CAN-Meldung