FC_MAreaRead - General Information

Overview

Type:

Function

Available as of:

SystemInterface_1.32.6.0

Versions:

Current version

Task

Consistently reading data from a marker area to a buffer in the program.

Description

The functions FC_MAreaRead() and FC_MAreaWrite() allow consistent data exchange between the marker area and a buffer of the program. The copying operation cannot be interrupted. This enables a consistent data exchange between the marker area and variables of the program regardless of the priority of the tasks. A number of bytes, i_udiByteCount, (0...65535), starting with the initial address, i_udiAddr, is read from the marker area (0...65535) and copied to the transferred buffer with the address i_diDestination. The transferred buffer must contain at least i_udiByteCount bytes.

Interface

Input

Data type

Description

i_udiAddr

UDINT

Starting address in the marker area

i_udiByteCount

UDINT

Number of bytes to be read

i_diDestination

DINT

Buffer address

Return Value

Data type

Description

DINT

0: OK

-1: invalid range specification