CL2.CreateMaskReceiver (FUN)

 

Diese Funktion der CAA_CanL2.library registriert einen Bezeichner­bereich 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 entsprech­ende Wert beim Filtern der Meldungen ignoriert.

Eingang:

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)

Ausgang:

hRegId

CAA.HANDLE

Handle für späteren Lesezugriff