F_iecCopyStreamToBufferByOffset

Diese Funktion kopiert Datenbytes von der stream-Variablen ab einer Byteoffsetposition in eine externe Puffervariable. Der Speicherinhalt der stream-Variablen bleibt unverändert. Der Rückgabeparameter der Funktion liefert die Anzahl der erfolgreich kopierten Datenbytes.

Syntax

FUNCTION F_iecCopyStreamToBufferByOffset: UDINT
VAR_INPUT
    pBuffer : PVOID;
    cbBuffer: UDINT;
    nOffset : UDINT;
END_VAR
VAR_IN_OUT
    stream  : ST_IEC870_5_101Stream;
END_VAR

Eingänge

pBuffer: Pointer (Adresse) einer externen Puffervariablen.

cbBuffer: Maximale Anzahl der Datenbytes die aus der stream-Variablen in den externen Puffer kopiert werden sollen.

nOffset: Byteoffsetposition des Quelldatenpuffers.

Ein-/Ausgänge

stream: Quelldatenpuffer.

Beispiel in ST

Bei einer steigenden Flanke am bRx werden vier Datenbytes ab dem Byteoffset 1 der stream-Variablen in die rxAtOffs-Variable kopiert.

PROGRAM P_iecCopyStreamToBufferByOffset
VAR
    stream   : ST_IEC870_5_101Stream := ( length := 8, data := [16#01, 16#AA, 16#BB, 16#CC, 16#DD, 16#06, 16#07, 16#08] );
    bRx      : BOOL;
    rxAtOffs : DWORD := 0;
    cbResult : UDINT := 0;
END_VAR

IF bRx THEN
    bRx := FALSE;
    cbResult := F_iecCopyStreamToBufferByOffset ( ADR( rxAtOffs ), SIZEOF( rxAtOffs ), 1, stream );
END_IF

Speicherdarstellung der stream-Variablen nach dem Programmstart:

length	data
8	16#01	16#AA	16#BB	16#CC	16#DD	16#06	16#07	16#08	16#00	16#00	...	IEC870_MAX_ASDU_DATA_BYTE

Speicherdarstellung der stream-Variablen nach dem F_iecCopyStreamToBufferByOffset-Funktionsaufruf:

length	data
8	16#01	16#AA	16#BB	16#CC	16#DD	16#06	16#07	16#08	16#00	16#00	...	IEC870_MAX_ASDU_DATA_BYTE

Die Variable rxAtOffs hat den Wert: 16#DDCCBBAA.

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS Bibliotheken (Kategoriegruppe)
TwinCAT v3.1.4012.0	PC oder CX (x86, x64, ARM)	Tc2_IEC60870_5_10x (Communication->IEC60870) Tc2_SerialCom (Communication->Serial) Tc2_TcpIp (Communication->TcpIp) Tc2_Utilities (System)