MSC_SetNotificationCallback

<< 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


MSC_OpenDevice

MSC_Start

 

Callback-Funktion

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.