query_io_deviceT_query_io_deviceQueryIoDevicequery_io_deviceQueryIoDeviceQueryIoDevice (Operator)

Name

query_io_deviceT_query_io_deviceQueryIoDevicequery_io_deviceQueryIoDeviceQueryIoDevice — Abfragen von Informationen über Kanäle eines I/O-Gerätes.

Signatur

query_io_device( : : IODeviceHandle, IOChannelName, Query : Result)

Der Operator query_io_devicequery_io_deviceQueryIoDevicequery_io_deviceQueryIoDeviceQueryIoDevice liefert Informationen zu den Übertragungskanälen, welche von einem spezifischen Gerät unterstützt werden. Die Referenz zu einem I/O-Gerät wird in IODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandle übergeben und die Kanäle über ihre Namen in IOChannelNameIOChannelNameIOChannelNameIOChannelNameIOChannelNameIOChannelName adressiert. Die gewünschte Information über die Kanäle wird mit QueryQueryQueryQueryQueryquery spezifiziert. Eine Liste aller unterstützten Kanalnamen erhält man, wenn QueryQueryQueryQueryQueryquery der Parametername 'io_channel_name'"io_channel_name""io_channel_name""io_channel_name""io_channel_name""io_channel_name" übergeben wird. Der Parameter IOChannelNameIOChannelNameIOChannelNameIOChannelNameIOChannelNameIOChannelName wird dabei 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".

Parallelisierung

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

IODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandle (input_control) io_device → (integer)

Referenz auf das geöffnete I/O-Gerät.

IOChannelNameIOChannelNameIOChannelNameIOChannelNameIOChannelNameIOChannelName (input_control) string(-array) → (string)

I/O-Kanalnamen.

QueryQueryQueryQueryQueryquery (input_control) string-array → (string)

Abzufragende Information.

Defaultwert: 'param_name' "param_name" "param_name" "param_name" "param_name" "param_name"

Werteliste: 'io_channel_names'"io_channel_names""io_channel_names""io_channel_names""io_channel_names""io_channel_names", 'param_name'"param_name""param_name""param_name""param_name""param_name"

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

Ergebniswerte (gemäß QueryQueryQueryQueryQueryquery).

Beispiel (HDevelop)

query_io_interface ('Advantech', 'io_device_name', DeviceNames)
open_io_device ('Advantech', 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

Operatoren