query_io_deviceT_query_io_deviceQueryIoDeviceQueryIoDevice (Operator)

Name

query_io_deviceT_query_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_deviceQueryIoDeviceQueryIoDeviceQueryIoDevice 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 IODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandle übergeben und die Kanäle über ihre Namen in IOChannelNameIOChannelNameIOChannelNameIOChannelNameIOChannelName adressiert. Die gewünschte Information über die Kanäle wird mit QueryQueryQueryQueryquery spezifiziert. Eine Liste aller unterstützten Kanalnamen erhält man, wenn QueryQueryQueryQueryquery der Parametername 'io_channel_name'"io_channel_name""io_channel_name""io_channel_name""io_channel_name" übergeben wird. Der Parameter IOChannelNameIOChannelNameIOChannelNameIOChannelNameIOChannelName 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".

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

IODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandle (input_control) io_device → (integer)

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

IOChannelNameIOChannelNameIOChannelNameIOChannelNameIOChannelName (input_control) string(-array) → (string)

I/O-Kanalnamen.

QueryQueryQueryQueryquery (input_control) string-array → (string)

Abzufragende Information.

Defaultwert: '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", 'param_name'"param_name""param_name""param_name""param_name"

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

Ergebniswerte (gemäß QueryQueryQueryQueryquery).

Beispiel (HDevelop)

* Select a suitable i/o device interface of name IOInterfaceName
query_io_interface (IOInterfaceName, 'io_device_name', 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_interfaceQueryIoInterfaceQueryIoInterfaceQueryIoInterface 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_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfo abgefragt werden kann.

Nachfolger

open_io_deviceopen_io_deviceOpenIoDeviceOpenIoDeviceOpenIoDevice

Modul

Foundation

Operatoren