F_iecCopyStreamToBuffer

Syntax

FUNCTION F_iecCopyStreamToBuffer: UDINT
VAR_INPUT
    pBuffer : PVOID;
    cbBuffer: 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.

Ein-/Ausgänge

stream: Quelldatenpuffer.

Beispiel in ST

Bei einer steigenden Flanke am bRx werden die ersten vier Datenbytes der stream-Variablen in die rxBufferA- und rxBufferB-Variable kopiert.

PROGRAM P_iecCopyStreamToBuffer
VAR
    stream    : ST_IEC870_5_101Stream := ( length := 4, data := [16#01, 16#02, 16#03, 16#04] );
    rxBufferA : ARRAY[0..3] OF BYTE;
    rxBufferB : ARRAY[0..3] OF BYTE;
    cbResult  : UDINT;
    bRx       : BOOL;
END_VAR

IF bRx THEN
    bRx := FALSE;
    cbResult := F_iecCopyStreamToBuffer ( ADR( rxBufferA ), SIZEOF( rxBufferA ), stream );
    cbResult := F_iecCopyStreamToBuffer ( ADR( rxBufferB ), SIZEOF( rxBufferB ), stream );
END_IF

Speicherdarstellung der stream-Variablen nach dem Programmstart:

Speicherdarstellung der stream-Variablen nach dem ersten und zweiten F_CopyStreamToBuffer-Funktionsaufruf:

Die rxBufferA und rxBufferB Array-Variable haben nach dem Aufruf folgenden Wert: [16#01, 16#02, 16#03, 16#04].

Voraussetzungen