CL2.CreateMessage (FUN)

 

Diese Funktion der CAA_CanL2.library stellt eine neue Meldung aus dem Datenbestand des Treibers zur Verfügung und macht diese über den Handle “hMessage” zugänglich. Darüber hinaus legt die Funktion den Bezeichner, das Cobold Format, die Datenlänge und das RTR-Flag der Meldung fest. Eine solche Meldung muss entweder mit CL2.Write versendet oder mit CL2.FreeMessage freigegeben werden. Sie kann auch mit Hilfe von “CL2.CloneMessage” dupliziert werden. Stehen der Meldung keine Ressourcen mehr zur Verfügung, dann gibt “CL2.Create­Message” den Wert “CAA.gc_hINVALID” zurück.

Eingang:

hDriver

CAA.HANDLE

Handle von CAN Schnittstelle

cobId

CL2I.COBID

Meldungs-ID

usiLength

USINT

Anzahl Datenbytes in Meldung

xRTR*

BOOL

RTR Flag der Meldung

x29BitID*

BOOL

FALSE: nur 11 Bit-Ids; TRUE: 29 Bit-Ids werden auch unterstützt

peError

POINTER TO CL2.ERROR

Zeiger auf Fehlercode (Aufzählungstyp)

Ausgang:

hMessage

CAA.HANDLE

Handle der Meldung