EcoStruxure Machine Expert Version 1.1 unterstützt nicht die Controller M258, LMC058 und LMC078.

Methode ReceiveOutOfBand

Überblick

Typ

Methode

Verfügbar ab

V1.0.4.0

G-SE-0045955.1.gif-high.gif

 

 

Aufgabe

Lesen und Entfernen der im Empfangspuffer gespeicherten OutOfBand-Daten.

Funktionsbeschreibung

Liest die im Empfangspuffer gespeicherten OutOfBand-Daten und entfernt sie anschließend, wenn kein Fehler erkannt wurde.

Der UDINT-Rückgabewert verweist auf die Anzahl der in den von der Anwendung bereitgestellten Puffer geschriebenen Bytes.

Zusätzliche Informationen zu den Empfangsmethoden finden Sie im Abschnitt Empfangsmethode.

Schnittstelle

Eingabe

Datentyp

Gültiger Bereich

Beschreibung

i_pbyReceiveBuffer

POINTER TO BYTE

-

Startadresse des Puffers, in den die empfangenen Daten geschrieben werden.

i_udiReceiveBufferSize

UDINT

1 ... 2147483647

Anzahl der zu lesenden Bytes.

HINWEIS: Der Wert darf die Größe des Puffers nicht überschreiten.

HINWEIS: Um eine Zugriffsverletzung aufgrund eines ungültigen Zeigerzugriffs auf den Speicher zu vermeiden, verwenden Sie den arithmetischen Operator SIZEOF in Verbindung mit dem Zielpuffer, um den Wert für i_udiReceiveBufferSize zu bestimmen.

Eingang/Ausgang

Datentyp

Gültiger Bereich

Beschreibung

iq_udiFillLevel

UDINT

1 ... 2147483647

Gibt den Füllstand des Puffers an.

Vor einem Funktionsaufruf:

Die Daten werden ab diesem Offset geschrieben.

Nach dem Funktionsaufruf:

Wird durch Hinzufügen der Anzahl der geschriebenen Bytes zum ursprünglichen Wert aktualisiert.

Verwendet von

oFB_TCPClient