Siemens SIMATIC S7-1500 Funktionshandbuch Seite 186

ReadBytes()
Liest ein Byte-Array aus der Area.
Hinweis
Die Funktion erlaubt Zugriff auf den gesamten Speicherbereich des virtuellen Controllers!
Nutzen Sie daher den Zugriff über den Variablennamen und nicht über die Adressbereiche.
Tabelle 7- 171 ReadByte() - Native C++
Syntax
Parameter
Rückgabewerte
S7-PLCSIM Advanced
Funktionshandbuch, 05/2021, A5E37039506-AD
ERuntimeErrorCode ReadBytes(
EArea in_Area,
UINT32 in_Offset,
UINT32 in_BytesToRead,
UINT32* out_BytesRead,
BYTE inout_Values[]
);
•
EArea in_Area:
Die Area, von der Sie lesen möchten. Zulässige Werte:
{SRA_INPUT, SRA_MARKER, SRA_OUTPUT}. Siehe EArea (Seite 390).
•
UINT32 in_Offset:
Der Byte-Offset innerhalb der Area. Der Wert muss zwischen 0 und dem Wert
sein, der von GetAreaSize() zurückgegeben wird.
•
UINT32 in_BytesToRead:
Enthält die Größe des Wertespeichers.
•
UINT32* out_BytesRead:
Enthält die Anzahl der Bytes, die gerade in den Wertespeicher geschrieben wur-
den.
•
BYTE inout_Values[]:
Der Speicher für die Bytes, die aus der Area gelesen werden.
Runtime Fehlercode
SREC_OK
SREC_INTERFACE_REMOVED
SREC_TIMEOUT
SREC_INSTANCE_NOT_RUNNING
SREC_INDEX_OUT_OF_RANGE
SREC_WRONG_ARGUMENT
Anwenderschnittstellen (API)
7.6 API IInstances
Bedingung
Die Funktion ist erfolgreich.
Die Instanz ist im Runtime Manager nicht
registriert.
Die Funktion kehrt nicht rechtzeitig wie-
der.
Der Prozess des virtuellen Controllers
läuft nicht.
Der Offset liegt außerhalb der Area-
Größe. Kein Byte konnte gelesen werden.
Die Area ist ungültig.
185