Inhaltsverzeichnis
Werbung
Kontrollbefehl get_values
Funktion
Liefert die aktuellen Werte von bis zu vier ausgewählten Signalen zurück.
Aufruf
get_values( SignalPtr, ResultPtr )
Parameter
SignalPtr Pointer (bei C und C++ Datentyp ULONG_PTR, d.h. 32-Bit- bzw. 64-Bit-Wert
ResultPtr Pointer (bei C und C++ Datentyp ULONG_PTR, d.h. 32-Bit- bzw. 64-Bit-Wert
Hinweise
• Es können bis zu vier beliebige Signale gleichzeitig ausgelesen werden. Die auswähl-
baren Signaltypen sind identisch wie beim Befehl
Wertebereich, die Signaltypen und entsprechende Hinweise siehe dort). Die
gewünschten Signaltypen müssen unter SignalPtr angegeben werden. Die zugehö-
rigen Signalwerte werden dann unter ResultPtr abgelegt. Zur Speicherung eines
ausgelesenen Datensatzes muss von der Anwendung jeweils (an der über ResultPtr
angegebenen Adresse) ein Speicherbereich der Größe 4 × 4 Byte auf dem PC bereitge-
stellt werden.
• get_values funktioniert ähnlich wie der get_value-Befehl (siehe Hinweise dort). Für
Kanäle, für die unter SignalPtr ein unzulässiger Signaltypwert angegeben wird, führt
get_values keine Signalabfrage aus und gibt den Wert 0 zurück. Ein get_last_error-
Returncode RTC5_PARAM_ERROR wird allerdings nur dann erzeugt, wenn alle vier ange-
gebenen Signaltypwerte ungültig sind.
• Ist mindestens einer der Zeigerparameter gleich NULL, wird der Befehl nicht ausgeführt
(alle Rückgabewerte sind 0) und ein get_last_error-Returncode RTC5_PARAM_ERROR
erzeugt.
®
®
RTC
4 RTC
5 Neuer Befehl.
Die vier zurückgegebenen Werte sind auch im RTC
®
RTC
5-20-Bit-Bereich, werden jedoch als 32-Bit-Werte an den PC übertragen und müssen
von Benutzern geeignet ausgewertet werden (siehe Hinweise bei get_value).
Versionsinfo
• Verfügbar ab Version DLL 516, OUT 515, RBF 512.
• Letzte Änderung (DLL 536, OUT 536): Weitere auswählbare Datensignale (siehe
set_trigger).
Verweise
get_value, set_trigger,
®
®
RTC
5 PCI-Karte, RTC
5 PCI-Express-Karte, RTC
Rev. 1.10 d
10 Befehle und Funktionen
ohne Vorzeichen) auf ein Array von vier 32-Bit-Werten ohne Vorzeichen, in
dem die gewünschten Signaltypen angegeben sind.
ohne Vorzeichen) auf ein Array von vier 32-Bit-Werten mit Vorzeichen, in dem
die aktuellen Werte der bis zu vier ausgewählten Signale abgelegt werden
sollen.
transform
®
5 PC/104-Plus-Karte, RTC
set_trigger
®
4-Kompatibilitätsmodus immer im
®
5 PCIe/104-Karte
(für den zulässigen
325
Werbung
Inhaltsverzeichnis
