Diese Funktion der CAA_CanL2.library registriert einen Bezeichnerbereich für zukünftige Aufrufe von CL2.Read. Im Prinzip ist sie identisch mit “CL2.RegisterId”. Im Gegensatz zu CL2.RegisterIdArea wird der Bereich nicht mittels Aufzählen der betreffenden Bezeichner, sondern mittels einer Kombination von Bit-Zeichen und den damit verbundenen Maskenwerten erstellt. Die sich daraus ergebende Bezeichnergruppe kann wie folgt werden:
Wert |
0 |
0 |
1 |
1 |
x: dieser Bit kann entweder TRUE oder FALSE sein |
Maske |
0 |
1 |
0 |
1 |
0: dieser Bit muss FALSE sein |
Ergebnis |
X |
0 |
x |
1 |
1: dieser Bit muss TRUE sein |
Aus diesem Grunde aktiviert eine auf TRUE gesetzte Maske den Wert in „Value“. Ist der Maskenwert gleich FALSE, dann wird der entsprechende Wert beim Filtern der Meldungen ignoriert.
hDriver |
CAA.HANDLE |
Handle von CAN Schnittstelle |
cobIdValue |
CL2I.COBID |
Bit-Zeichen von Bezeichner der Meldung |
cobIdMask |
CL2I.COBID |
Maske für Bit-Zeichen von cobIdValue |
xRTRValue |
BOOL |
Bit-Zeichen für RTR-Flag |
xRTRMask |
BOOL |
Maske für Bit-Zeichen von xRTRValue |
x29BitIdValue |
BOOL |
Bit-Zeichen von Meldungstyp |
x29IdMask |
BOOL |
Maske für Bit-Zeichen von x29BitIdValue |
xTransmitValue |
BOOL |
Bit-Zeichen von Rückmeldung |
xTransmitMask |
BOOL |
Maske für Bit-Zeichen von xTransmitValue |
xAlwaysNewest* |
BOOL |
TRUE: nur die jüngste Meldung wird gespeichert; FALSE: alle empfangenen Meldungen werden in chronologischer Reihenfolge gespeichert |
eEvent* |
CB_EVENT |
Ereignis, das bei Empfang einer Meldung aktiviert werden muss 0: kein Ereignis |
xEnableSyncWindow* |
BOOL |
Empfang ausschließlich in Sync Fenster |
peError |
POINTER TO CL2.ERROR |
Zeiger auf Fehlercode (Aufzählungstyp) |
hRegId |
CAA.HANDLE |
Handle für späteren Lesezugriff |