|
<< Click to Display Table of Contents >> Navigation: MscDll Referenzhandbuch > Programmierschnittstelle > Benachrichtigungen (Notifications) > MSC_SetNotificationMessage |
Diese Funktion aktiviert das Senden von Windows Messages für Benachrichtigungen.
Details zum Empfang von Windows Messages entnehmen Sie der Dokumentation Ihrer Entwicklungsumgebung.
Definition
MSC_STATUS
MSC_SetNotificationMessage(
MSC_HANDLE Handle,
int OpCode,
HWND hWnd,
ULONG MsgCode,
ULONG wParam,
ULONG lParam
);
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).
hWnd
Ein Windows-Handle, das die Message empfängt.
MsgCode
Von der Applikation festzulegende Message-Nummer.
wParam
Der wParam der Windows-Message.
lParam
Der lParam der Windows-Message.
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 hWnd = NULL aufgerufen wird.
Anmerkung zum MsgCode
Die Message-Nummer wird von der Applikation beliebig festgelegt. Unter Visual C++ kann dies beispielsweise wie folgt aussehen:
#define WM_MESSAGE_MSC_READSTATIC (WM_USER + 0)
#define WM_MESSAGE_MSC_BITIO (WM_USER + 1)
#define WM_MESSAGE_MSC_HW_STATUS (WM_USER + 2)
Siehe auch