AdsSyncAddDeviceNotificationReq

Innerhalb eines ADS-Servers (z.B. SPS) wird eine Notification (Bekanntmachung) definiert. Beim Eintreten bestimmter Ereignisse, wird eine Funktion (Callbackfunktion) im ADS-Client (C-Programm) aufgerufen.

LONG AdsSyncAddDeviceNotificationReq(
  PAmsAddr                pAddr,
  ULONG                   nIndexGroup,
  ULONG                   nIndexOffset,
  PAdsNotificationAttrib  pNoteAttrib,
  PAdsNotificationFuncEx  pNoteFunc,
  ULONG                   hUser,
  PULONG                  pNotification
);

Parameter

pAddr

[in] Struktur mit NetId und Portnummer vom ADS-Server.

nIndexGroup

[in] IndexGroup.

nIndexOffset

[in] IndexOffset.

pNoteAttrib

[in] Zeiger auf die Struktur, welche weitere Informationen enthält.

pNoteFunc

[in] Name der Callback-Funktion.

hUser

[in] 32-Bit Wert, welcher an die Callback-Funktion übergeben wird.

pNotification

[out] Adresse der Variablen, die das Handle der Notification aufnimmt.

Rückgabewert

Gibt den Fehlerstatus der Funktion zurück.

 

Limitierung :

Pro ADS-Port steht eine begrenzte Anzahl von 550 Notifications zur Verfügung.

Anmerkungen

Wird der TwinCAT-Router gestoppt und wieder gestartet, so sind die Notifications ungültig. Mit der Funktion AdsAmsRegisterRouterNotification() können Sie dieses Ereignis abfangen.

Beispiel

Siehe Beispiel 8: Ereignisgesteuertes Lesen