|
<< Click to Display Table of Contents >> Navigation: MscDll Referenzhandbuch > Programmierschnittstelle > Benachrichtigungen (Notifications) > MSC_SetNotificationEvent |
Diese Funktion registriert einen Event zur Benachrichtigung.
Details zur Anwendung von Events entnehmen Sie der Dokumentation Ihrer Entwicklungsumgebung.
Definition
MSC_STATUS
MSC_SetNotificationEvent(
MSC_HANDLE Handle,
int OpCode,
HANDLE Event
);
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).
Event
Das initialisierte Event-Handle.
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 und für statische sowie dynamische Kanäle genutzt.
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 komplett voll ist.
Die Benachrichtigung kann auch nicht registriert sein, wenn die Funktion mit Event=NULL aufgerufen wird.
Die DLL setzt diesen Event niemals zurück.
Siehe auch