control_io_interfaceT_control_io_interfaceControlIoInterfaceControlIoInterface (Operator)
Name
control_io_interfaceT_control_io_interfaceControlIoInterfaceControlIoInterface — Ausführen einer Aktion auf der I/O-Schnittstelle.
Signatur
void ControlIoInterface(const HTuple& IOInterfaceName, const HTuple& Action, const HTuple& Argument, HTuple* Result)
static HTuple HIODevice::ControlIoInterface(const HString& IOInterfaceName, const HString& Action, const HTuple& Argument)
static HTuple HIODevice::ControlIoInterface(const HString& IOInterfaceName, const HString& Action, const HString& Argument)
static HTuple HIODevice::ControlIoInterface(const char* IOInterfaceName, const char* Action, const char* Argument)
static HTuple HIODevice::ControlIoInterface(const wchar_t* IOInterfaceName, const wchar_t* Action, const wchar_t* Argument)
(Nur Windows)
Beschreibung
control_io_interfacecontrol_io_interfaceControlIoInterfaceControlIoInterfaceControlIoInterface führt eine Aktion auf der
I/O-Schnittstelle aus, wozu noch kein I/O-Gerät mit
open_io_deviceopen_io_deviceOpenIoDeviceOpenIoDeviceOpenIoDevice geöffnet worden sein muss. Die unterstützten
Parameterwerte für die Aktion, welche in ActionActionActionActionaction übergeben
wird, und ihr optionales Argument in ArgumentArgumentArgumentArgumentargument hängen von
der entsprechenden I/O-Schnittstelle ab. Die Beschreibung der
gerätespezifischen Parameterwerte sind in der entsprechenden
Dokumentation der Schnittstelle gelistet, die sich im Verzeichnis
'doc/html/reference/io'"doc/html/reference/io""doc/html/reference/io""doc/html/reference/io""doc/html/reference/io" findet.
Der besondere Wert 'keep_open'"keep_open""keep_open""keep_open""keep_open" für ActionActionActionActionaction steuert, wann
die I/O-Schnittstelle entladen wird. Wird ArgumentArgumentArgumentArgumentargument auf
'true'"true""true""true""true" gesetzt, wird die I/O-Schnittstelle erst dann entladen, wenn
der HALCON-Prozeß beendet wird. Ist er auf 'false'"false""false""false""false" gesetzt, wird die
I/O-Schnittstelle entladen, sobald wie an dieser Schnittstelle keien Geräte
mehr offen sind. Diese ist das Standardverhalten.
Achtung
Auf Windows Systemen können Fehler-Dialogboxen vom Betriebssystems erscheinen, wenn abhängende Module des Interfaces nicht gefunden werden können. Dies ist beispielsweise der Fall, wenn das entsprechende SDK nicht installiert wurde. Das Erscheinen der Dialogboxen kann über Windows Error Mode kontrolliert werden. Informationen dazu finden sich in der Beschreibung von SetErrorMode in der MSDN Dokumentation.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
IOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceName (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Name der HALCON I/O-Schnittstelle.
Defaultwert: []
Wertevorschläge: 'ADLINK-DAQPilot'"ADLINK-DAQPilot""ADLINK-DAQPilot""ADLINK-DAQPilot""ADLINK-DAQPilot", 'ADLINK-EOS'"ADLINK-EOS""ADLINK-EOS""ADLINK-EOS""ADLINK-EOS", 'Advantech'"Advantech""Advantech""Advantech""Advantech", 'Contec'"Contec""Contec""Contec""Contec", 'Hilscher-cifX'"Hilscher-cifX""Hilscher-cifX""Hilscher-cifX""Hilscher-cifX", 'Interface'"Interface""Interface""Interface""Interface", 'NIDAQmx'"NIDAQmx""NIDAQmx""NIDAQmx""NIDAQmx", 'OPC_Classic'"OPC_Classic""OPC_Classic""OPC_Classic""OPC_Classic", 'OPC_UA'"OPC_UA""OPC_UA""OPC_UA""OPC_UA"
ActionActionActionActionaction (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Name der auszuführenden Aktion.
ArgumentArgumentArgumentArgumentargument (input_control) string(-array) → HTupleHTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Argumente der auszuführenden Aktion.
Defaultwert: []
ResultResultResultResultresult (output_control) string-array → HTupleHTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Ergebniswerte der ausgeführten Aktion.
Ergebnis
Der Operator control_io_interfacecontrol_io_interfaceControlIoInterfaceControlIoInterfaceControlIoInterface liefert den Wert
2 (H_MSG_TRUE), wenn die angeforderte Aktion korrekt ausgeführt
werden konnte. Ansonsten wird eine Fehlerbehandlung durchgeführt. In diesem Fall kann vom Interface eine zusätzliche Fehlerinformation gesetzt werden, die mit get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfo abgefragt werden kann.
Siehe auch
query_io_interfacequery_io_interfaceQueryIoInterfaceQueryIoInterfaceQueryIoInterface
Modul
Foundation