Siemens SIMATIC S7-1500 Funktionshandbuch Seite 182

ReadBit()
Liest ein einzelnes Bit aus der Area.
Hinweis
Die Funktion erlaubt Zugriff auf den gesamten Speicherbereich des virtuellen Controllers!
Nutzen Sie daher den Zugriff über den Variablennamen (Seite 196) und nicht über die
Adressbereiche.
Tabelle 7- 167 ReadBit() - Native C++
Syntax
Parameter
Rückgabewerte
S7-PLCSIM Advanced
Funktionshandbuch, 05/2021, A5E37039506-AD
ERuntimeErrorCode ReadBit(
EArea in_Area,
UINT32 in_Offset,
UINT8 in_Bit,
bool* out_Value
);
•
EArea in_Area:
Die Area , von der gelesen werden soll. 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, den GetAreaSize() zurückgibt.
•
UINT8 in_Bit:
Der Bit-Offset innerhalb des Bytes. Der Wert muss zwischen 0 und 7 sein.
•
bool* out_Value:
Gibt den Bitwert zurück.
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.
Offset oder Bits sind ungültig.
Die Area ist ungültig.
181