control_io_interface [HALCON Operator-Referenz / Version 17.12]

control_io_interfaceT_control_io_interfaceControlIoInterfaceControlIoInterface — Ausführen einer Aktion auf der I/O-Schnittstelle.

Signatur

Herror T_control_io_interface(const Htuple IOInterfaceName, const Htuple Action, const Htuple Argument, Htuple* Result)

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)

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

Parameter

IOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceName (input_control) string → (string)

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", '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 → (string)

Name der auszuführenden Aktion.

ArgumentArgumentArgumentArgumentargument (input_control) string(-array) → (string / integer / real)

Argumente der auszuführenden Aktion.

Defaultwert: []

ResultResultResultResultresult (output_control) string-array → (string / integer / real)

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.

control_io_interfaceT_control_io_interfaceControlIoInterfaceControlIoInterface (Operator)

Name