Overview
|
Type:
|
Function
|
|
Available as of:
|
SystemInterface_1.32.6.0
|
|
Versions:
|
Current version
|
Task
Consistently writing 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. From the transferred buffer with the address i_diSource of the program, the number of bytes i_udiByteCount (0...65535), is written to the marker area (0...65535), starting with the initial address, i_udiAddr.
NOTE: The function is only run if there is a valid range specification. That means the entire range must be in the available marker area (0 … 65535). Thus, the following holds: (i_udiAddr + i_udiByteCount) <= 65536
Interface
|
Input
|
Data type
|
Description
|
|
i_udiAddr
|
UDINT
|
Starting address in the marker area
|
|
i_udiByteCount
|
UDINT
|
Number of bytes to be written
|
|
i_diSource
|
DINT
|
Address of the buffer from which the data are to be read
|
Return Value
|
Data type
|
Description
|
|
DINT
|
0: OK
-1: invalid range specification
|