control_io_interfaceT_control_io_interfaceControlIoInterfaceControlIoInterfacecontrol_io_interface (Operator)
Name
control_io_interfaceT_control_io_interfaceControlIoInterfaceControlIoInterfacecontrol_io_interface — 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_interfaceControlIoInterfaceControlIoInterfaceControlIoInterfacecontrol_io_interface führt eine Aktion auf der
I/O-Schnittstelle aus, wozu noch kein I/O-Gerät mit
open_io_deviceopen_io_deviceOpenIoDeviceOpenIoDeviceOpenIoDeviceopen_io_device geöffnet worden sein muss. Die unterstützten
Parameterwerte für die Aktion, welche in ActionActionActionActionactionaction übergeben
wird, und ihr optionales Argument in ArgumentArgumentArgumentArgumentargumentargument 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 findet.
Der besondere Wert 'keep_open'"keep_open""keep_open""keep_open""keep_open""keep_open" für ActionActionActionActionactionaction steuert, wann
die I/O-Schnittstelle entladen wird. Wird ArgumentArgumentArgumentArgumentargumentargument auf
'true'"true""true""true""true""true" gesetzt, wird die I/O-Schnittstelle erst dann entladen, wenn
der HALCON-Prozess beendet wird. Ist er auf 'false'"false""false""false""false""false" gesetzt, wird die
I/O-Schnittstelle entladen, sobald wie an dieser Schnittstelle keine 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
IOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceNameiointerface_name (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name der HALCON I/O-Schnittstelle.
Defaultwert: []
Wertevorschläge: 'ADLINK-DAQPilot'"ADLINK-DAQPilot""ADLINK-DAQPilot""ADLINK-DAQPilot""ADLINK-DAQPilot""ADLINK-DAQPilot", 'ADLINK-EOS'"ADLINK-EOS""ADLINK-EOS""ADLINK-EOS""ADLINK-EOS""ADLINK-EOS", 'Advantech'"Advantech""Advantech""Advantech""Advantech""Advantech", 'Contec'"Contec""Contec""Contec""Contec""Contec", 'Hilscher-cifX'"Hilscher-cifX""Hilscher-cifX""Hilscher-cifX""Hilscher-cifX""Hilscher-cifX", 'Interface'"Interface""Interface""Interface""Interface""Interface", 'Linux-GPIO'"Linux-GPIO""Linux-GPIO""Linux-GPIO""Linux-GPIO""Linux-GPIO", 'NIDAQmx'"NIDAQmx""NIDAQmx""NIDAQmx""NIDAQmx""NIDAQmx", 'OPC_Classic'"OPC_Classic""OPC_Classic""OPC_Classic""OPC_Classic""OPC_Classic", 'OPC_UA'"OPC_UA""OPC_UA""OPC_UA""OPC_UA""OPC_UA"
ActionActionActionActionactionaction (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name der auszuführenden Aktion.
ArgumentArgumentArgumentArgumentargumentargument (input_control) string(-array) → HTupleMaybeSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Argumente der auszuführenden Aktion.
Defaultwert: []
ResultResultResultResultresultresult (output_control) string-array → HTupleSequence[Union[int, float, str]]HTupleHtuple (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_interfaceControlIoInterfaceControlIoInterfaceControlIoInterfacecontrol_io_interface liefert den Wert
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_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info abgefragt werden kann.
Siehe auch
query_io_interfacequery_io_interfaceQueryIoInterfaceQueryIoInterfaceQueryIoInterfacequery_io_interface
Modul
Foundation