HALCON Website / HALCON Operator-Referenz / System / I/O-Geräte
KlassenKlassenKlassenKlassen | | | | Operatoren

control_io_interfaceT_control_io_interfaceControlIoInterfacecontrol_io_interfaceControlIoInterfaceControlIoInterface (Operator)

Name

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

Signatur

control_io_interface( : : IOInterfaceName, Action, Argument : Result)

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

Herror control_io_interface(const HTuple& IOInterfaceName, const HTuple& Action, const HTuple& Argument, HTuple* Result)

HTuple HIODevice::ControlIoInterface(const HTuple& IOInterfaceName, const HTuple& Action, const HTuple& Argument)

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)

void HOperatorSetX.ControlIoInterface(
[in] VARIANT IOInterfaceName, [in] VARIANT Action, [in] VARIANT Argument, [out] VARIANT* Result)

VARIANT HIODeviceX.ControlIoInterface(
[in] BSTR IOInterfaceName, [in] BSTR Action, [in] VARIANT Argument)

static void HOperatorSet.ControlIoInterface(HTuple IOInterfaceName, HTuple action, HTuple argument, out HTuple result)

static HTuple HIODevice.ControlIoInterface(string IOInterfaceName, string action, HTuple argument)

static HTuple HIODevice.ControlIoInterface(string IOInterfaceName, string action, string argument)

Beschreibung

control_io_interfacecontrol_io_interfaceControlIoInterfacecontrol_io_interfaceControlIoInterfaceControlIoInterface führt eine Aktion auf der I/O-Schnittstelle aus, wozu noch kein I/O-Gerät mit open_io_deviceopen_io_deviceOpenIoDeviceopen_io_deviceOpenIoDeviceOpenIoDevice 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'"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""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-Prozeß beendet wird. Ist er auf 'false'"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.

Parallelisierung

Parameter

IOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceName (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Name der HALCON I/O-Schnittstelle.

Defaultwert: []

Wertevorschläge: 'Advantech'"Advantech""Advantech""Advantech""Advantech""Advantech", 'Contec'"Contec""Contec""Contec""Contec""Contec", 'Interface'"Interface""Interface""Interface""Interface""Interface", '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 → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Name der auszuführenden Aktion.

ArgumentArgumentArgumentArgumentArgumentargument (input_control)  string(-array) → HTupleHTupleHTupleVARIANTHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double) (BSTR / Hlong / double) (char* / Hlong / double)

Argumente der auszuführenden Aktion.

Defaultwert: []

ResultResultResultResultResultresult (output_control)  string-array → HTupleHTupleHTupleVARIANTHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double) (BSTR / Hlong / double) (char* / Hlong / double)

Ergebniswerte der ausgeführten Aktion.

Ergebnis

Der Operator control_io_interfacecontrol_io_interfaceControlIoInterfacecontrol_io_interfaceControlIoInterfaceControlIoInterface 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_infoGetExtendedErrorInfoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfo abgefragt werden kann.

Siehe auch

query_io_interfacequery_io_interfaceQueryIoInterfacequery_io_interfaceQueryIoInterfaceQueryIoInterface

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH