ReadUserDataBuffer

Diese Funktion wird verwendet, um Daten zu lesen, die im Benutzerdatenfeld des aktuell aktivierten Standard-Kommunikationsprotokolls enthalten sind. Die referenzierte Buffer-Datenstruktur, die von einer FormatInputBuffer-Funktion erstellt wird, bestimmt, wie die empfangenen Daten interpretiert werden.

ReadUserDataBuffer – Eingaben

Parameter Beschreibung
Ereignis

Definiert das Aktualisierungsereignis, bei dem Daten gelesen werden sollen.

Dieser Parameter muss ein Verweis auf ein Ereignis mit einem Zeitstempel sein, z. B.: 

  • Eine Zelle, die eine Event-Funktion enthält.
  • Eine Zelle, die eine Button-Funktion enthält.
Puffer Gibt einen Verweis auf eine von einer FormatInputBuffer-Funktion erstellte Buffer-Datenstruktur an, die bestimmt, wie die empfangenen Daten interpretiert werden.
Protokoll

Legt fest, von welchem Protokoll die Anwenderdaten gelesen werden sollen.

1 = Ethernet/IP Gibt an, dass Ethernet/IP das aktivierte Standard-Kommunikationsprotokoll ist.
2 = PROFINET Gibt an, dass PROFINET das aktivierte Standard-Kommunikationsprotokoll ist.
100 = Standard Gibt an, dass das aktuell aktivierte Standard-Kommunikationsprotokoll verwendet werden soll. Wenn mehr als ein Protokoll aktiviert ist, wird das zuerst aktivierte Protokoll verwendet.
Verbindung überprüfen Legt fest, ob die Funktion versuchen soll, die Verbindung zu überprüfen. Bei Aktivierung gibt die Funktion #ERR zurück, wenn das ausgewählte Protokoll keine aktive zyklische Verbindung aufweist.
Byte-/Wortreihenfolge

Gibt die Bitreihenfolge für Wörter und Bytes an, die von der Funktion gelesen wurden.

0 = Big-Endian Gibt an, dass das höchstwertige Byte zuerst und nachfolgende Bytes in absteigender Reihenfolge gespeichert werden.
1 = Little-Endian Gibt an, dass das niedrigstwertige Byte zuerst und nachfolgende Bytes in aufsteigender Reihenfolge gespeichert werden.
2 = Big-Endian mit Austausch von 16-Bit-Wörtern Der Big-Endian-Byte-Stil wird angewendet und bei Doppelworttypen wird die Reihenfolge der Wortpaare geändert. (16-Bit-Wörter)
3 = Little-Endian mit Austausch von 16-Bit-Wörtern Der Little-Endian-Byte-Stil wird angewendet und bei Doppelworttypen wird die Reihenfolge der Wortpaare geändert. (16-Bit-Wörter)
100 = Standard Die Standardeinstellung wird verwendet.

ReadUserDataBuffer – Ausgaben

Rückgabewert

Eine UserData-Datenstruktur, die die von einem Client gesendeten Daten enthält, oder #ERR:

  • wenn Eingabeparameter ungültig sind
  • wenn keine Verbindung von einem Client aufgebaut wurde

  • wenn der Datenpuffer seit dem Verbindungsaufbau nicht geschrieben wurde
Ergebnisse Auf Daten in der UserData-Datenstruktur wird unter Verwendung der GetBufferData-Funktion zugegriffen. Weitere Informationen finden Sie im Thema Eingang/Ausgang.