KlassenKlassenKlassenKlassen | | | | Operatoren

query_io_interfaceT_query_io_interfaceQueryIoInterfacequery_io_interfaceQueryIoInterfaceQueryIoInterface (Operator)

Name

query_io_interfaceT_query_io_interfaceQueryIoInterfacequery_io_interfaceQueryIoInterfaceQueryIoInterface — Abfragen von Informationen zu einer I/O-Geräteschnittstelle.

Signatur

query_io_interface( : : IOInterfaceName, Query : Result)

Herror T_query_io_interface(const Htuple IOInterfaceName, const Htuple Query, Htuple* Result)

Herror query_io_interface(const HTuple& IOInterfaceName, const HTuple& Query, HTuple* Result)

HTuple HIODevice::QueryIoInterface(const HTuple& IOInterfaceName, const HTuple& Query)

void QueryIoInterface(const HTuple& IOInterfaceName, const HTuple& Query, HTuple* Result)

static HTuple HIODevice::QueryIoInterface(const HString& IOInterfaceName, const HTuple& Query)

static HTuple HIODevice::QueryIoInterface(const HString& IOInterfaceName, const HString& Query)

static HTuple HIODevice::QueryIoInterface(const char* IOInterfaceName, const char* Query)

void HOperatorSetX.QueryIoInterface(
[in] VARIANT IOInterfaceName, [in] VARIANT Query, [out] VARIANT* Result)

VARIANT HIODeviceX.QueryIoInterface(
[in] BSTR IOInterfaceName, [in] VARIANT Query)

static void HOperatorSet.QueryIoInterface(HTuple IOInterfaceName, HTuple query, out HTuple result)

static HTuple HIODevice.QueryIoInterface(string IOInterfaceName, HTuple query)

static HTuple HIODevice.QueryIoInterface(string IOInterfaceName, string query)

Beschreibung

Der Operator query_io_interfacequery_io_interfaceQueryIoInterfacequery_io_interfaceQueryIoInterfaceQueryIoInterface liefert Informationen zur angegebenen I/O-Geräteschnittstelle IOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceName. Die gewünschte Art der Information wird über den Parameter QueryQueryQueryQueryQueryquery ausgewählt. In ResultResultResultResultResultresult wird die angeforderte Information zurückgegeben.

Mit dem Parameterwert 'interface_name'"interface_name""interface_name""interface_name""interface_name""interface_name" für QueryQueryQueryQueryQueryquery können alle verfügbaren HALCON I/O-Schnittstellen abgefragt werden. In diesem Fall wird der Wert für IOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceName ignoriert.

Die Beschreibung aller gerätespezifischen Parameter findet sich in der Dokumentation für die verwendete I/O-Schnittstelle 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".

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"

QueryQueryQueryQueryQueryquery (input_control)  string(-array) HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Parametername der Anfrage.

Defaultwert: 'io_device_names' "io_device_names" "io_device_names" "io_device_names" "io_device_names" "io_device_names"

Wertevorschläge: 'revision'"revision""revision""revision""revision""revision", 'io_device_names'"io_device_names""io_device_names""io_device_names""io_device_names""io_device_names", 'param_name'"param_name""param_name""param_name""param_name""param_name"

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)

Liste der Ergebniswerte (abhängig von QueryQueryQueryQueryQueryquery).

Beispiel (HDevelop)

* Select a suitable i/o device interface of name IOInterfaceName
query_io_interface (IOInterfaceName, 'io_device_names', DeviceNames)
open_io_device (IOInterfaceName, DeviceNames[0], [], [], IODeviceHandle)
query_io_device (IODeviceHandle, [], 'io_channel_names.digital_input', ChannelInputNames)
open_io_channel (IODeviceHandle, ChannelInputNames[0], [], [], IOChannelHandle)
read_io_channel (IOChannelHandle, Value, Status)

Ergebnis

Sind die Parameterwerte korrekt und ist die angegebene I/O-Schnittstelle verfügbar, liefert query_io_interfacequery_io_interfaceQueryIoInterfacequery_io_interfaceQueryIoInterfaceQueryIoInterface den Wert 2 (H_MSG_TRUE). 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.

Nachfolger

open_io_deviceopen_io_deviceOpenIoDeviceopen_io_deviceOpenIoDeviceOpenIoDevice

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren