|
<< Click to Display Table of Contents >> Navigation: MscDll Referenzhandbuch > Programmierschnittstelle > Benachrichtigungen (Notifications) > MSC_SetNotificationCallback |
Diese Funktion registriert eine Callback-Funktion zur Benachrichtigung.
Definition
MSC_STATUS
MSC_SetNotificationCallback(
MSC_HANDLE Handle,
int OpCode,
MSC_NOTIFICATION_CALLBACK* CallbackFunction,
void* NotificationContext
);
Parameter
Handle
Handle zu dem Gerät (Irinos-System), das bei einem früheren Aufruf der Funktion MSC_OpenDevice zurückgegeben wurde.
Opcode
oDer Opcode des statischen Kanals, für den eine Message beim Eintreffen neuer Daten gesendet werden soll (opcRS, opcRHS oder opcBIO).
o-1 für eine Benachrichtigung bei einem Verbindungstimeout (siehe MSC_Start).
oDer Opcode der dynamischen Messung, für die eine Message bei einem vollen Empfangspuffer gesendet werden soll (opcRDM1 oder opcRDM2).
CallbackFunction
Die Adresse der Callback-Funktion. Eingabe von NULL, um die Registrierung aufzuheben.
NotificationContext
Ein Zeiger auf kontextabhängige Daten, der unverändert an die Callback Funktion weitergegeben wird.
Rückgabewert
Die Funktion gibt im Erfolgsfall MSC_STATUS_SUCCESS zurück, bei Fehlern wird der Fehlercode zurückgegeben.
Kommentare
Die Benachrichtigung wird nur für Geräte sowie für statische und dynamische Kanäle verwendet. Bei einem Gerät stellt die Benachrichtigung einen Fehler fest.
Bei einem statischen Kanal wird die Benachrichtigung jedes Mal gesendet, wenn Daten empfangen werden; einmal in jeder Sendeperiode.
Bei einem dynamischen Kanal wird die Benachrichtigung nur gesendet, wenn der Empfangspuffer vollständig gefüllt ist.
Die Benachrichtigung kann auch aufgehoben werden, wenn die Funktion mit Callback=NULL aufgerufen wird.
Die Callback-Funktion wird aus dem Thread der Kommunikation heraus aufgerufen. Führen Sie nur wenig Code in der Callback-Funktion aus, da sonst die Kommunikation ausgebremst oder unterbrochen werden kann.
Siehe auch
Diese Funktion ist ein Prototyp für eine callback-Benachrichtigung.
Definition
void
MSC_NOTIFICATION_CALLBACK(
void* NotificationContext
);
Parameter
NotificationContext
Dieser Parameter ist der gleiche, der an die Funktion MSC_SetNotificationCallback gegeben wurde. Die Anwendung kann über diesen Pointer Kontextinformation speichern.
Kommentare
Diese Funktion wird in einem anderen Thread Kontext aufgerufen. Die Anwendung muss für die Synchronisation sorgen.