CXI-Basis-Programmierreferenz / Version 2 / Datenaustausch / Ebene 2 / CxiMessageHandler /

DispatchExternalMessage - Externe Meldung lokal weiterleiten

CxiError CxiMessageHandler :: DispatchExternalMessage (void *msgdata, CxiLong msgsize)
static CxiError CXIB :: DispatchExternalMessage (void *msgdata, CxiLong msgsize, const char *msgid)
CxiError cxiDispatchExternalMessage (void *msgdata, CxiLong msgsize, const char *msgid)

Leitet eine empfangene externe Meldung lokal weiter

msgdata:
Zeiger auf empfangenen Datenblock

msgsize:
Größe des empfangenen Datenblocks

msgid:
Name des Treibers (für Antwort), wird bei der Memberfunktion automatisch gesetzt

return:
0 ok, sonst Fehler

Jeder Meldungstreiber ist gleichzeitig Sender und Empfänger. Auf der Empfängerseite eingegangene Datenblöcke werden nicht vom Treiber selbst verarbeitet, sondern lediglich an DispatchExternalMessage weitergegeben.

Portabilität:
Diese Funktionen sind in allen unterstützten Systemen verfügbar.

Weitere Memberfunktionen:
CxiMessageHandler(...) - Konstruktor
Handler2 - Bearbeitungsfunktion
WaitState - Wartezustand
Post - Verschicken einer erweiterten Meldung
Pass - Weiterleiten einer empfangenen Meldung
SetDriverMode - Meldungstreiber
IsInHandler - Ist der Handler aktiv?
QueryReceiverState - Aktivierungsstatus
RequestShutDown - Herunterfahren eines Empfängers

Siehe auch:
Klassenhierarchie Meldungssystem
class CxiMessageHandlerBase - Basisempfänger
class CxiMessageHandler - Erweiterter Meldungsempfänger
class CxiMessageHandlerWithQueue - Erweiterter Meldungsempfänger mit Queue