CXI-Basis-Programmierreferenz / Version 2 / Datenaustausch / Ebene 1 /
CxiReceiverState CxiMessageHandlerBase :: QueryReceiverState (void)
Aktivierungsstatus des Empfängers
return:
siehe Text
QueryReceiverState liefert den aktuellen Empfangsstatus des Empfängers zurück. Es ist eine der folgenden Konstanten:
cxiReceiverStateInit:
Der Empfänger befindet sich in der Initialisierungsphase, er kann noch keine Meldungen entgegennehmen.
cxiReceiverStateWaiting:
Der Empfänger ist bereit zur Verarbeitung von Meldungen, es liegen jedoch keine Daten vor.
cxiReceiverStateExecuting:
Die Verarbeitung einer Meldung wird gerade vor- oder nachbereitet. Dies ist daher ein kurzfristiger Status.
cxiReceiverStateHandler:
Eine Meldung wird gerade von der Handler-Funktion verarbeitet. Dieser Status gilt auch, wenn über WaitState eine Rekursion auftreten sollte. Er wird erst verlassen, wenn KEINE Meldung mehr in Bearbeitung ist. Ist IsInHandler() == 1, so kann der Status cxiReceiverStateHandler nicht verlassen werden, ohne dass die aufrufende Funktion sich mit return beendet.
cxiReceiverStateTerminating:
Der Empfänger soll beendet werden (siehe RequestShutDown). Er ist gerade beim Herunterfahren. Es sollten keine Meldungen mehr an ihn geschickt werden, da diese verloren gehen könnten.
cxiReceiverStateShutDown:
Der Empfänger ist heruntergefahren und inaktiv. Er kann gefahrlos gelöscht werden.
cxiReceiverStateUnknown:
Es liegt ein Fehler oder ein unbekannter Status vor.
QueryReceiverState bezieht sich nur auf die interne Verarbeitung der CXI-Basisklassen (CxiMessageHandler...), nicht auf die Objekte selbst. Diese müssen anschließend normal gelöscht werden. Die Rückgabe cxiReceiverStateShutDown bedeutet, dass von CXI-Seite keine asynchronen Zugriffe auf das Objekt mehr erfolgen.
Portabilität:
Diese Funktion ist ab Version 2.07 definiert und in allen unterstützten Systemen verfügbar.
Weitere Memberfunktionen:
CxiMessageHandlerBase(const char*) - Konstruktor
~CxiMessageHandlerBase() - Destruktor
WaitShutDown - Warten auf Handler
IsInHandler - Ist der Handler aktiv?
RequestShutDown - Herunterfahren eines Empfängers
CreateLocalAlias - Lokaler Aliasname
WaitState - Wartezustand
Handler1 - Bearbeitungsfunktion
Geerbte Memberfunktionen:
Status - Statusabfrage
IsValid - Ist Objekt gültig?
IsLocal - Ist Objekt lokal?
CountChildren - Anzahl untergeordneter Objekte
QueryIdent - Abfrage des Namens
QueryIdentAbs - Abfrage des absoluten Namens
Globale Funktionen:
PostMessageBlock - Versenden einer Meldung ohne Warten
SendMessageBlock - Versenden einer Meldung mit Warten
CreateGlobalAlias - Globaler Aliasname
Siehe auch:
Klassenhierarchie Meldungssystem
class CxiMessageIdent - Adresse eines Meldungsempfängers
class CxiMessageHandlerBase - Meldungsempfänger Ebene 1
class CxiMessageHandler - Erweiterter Meldungsempfänger
class CxiMessageHandlerWithQueue - Erweiterter Meldungsempfänger mit Queue