query_io_device — Abfragen von Informationen über Kanäle eines I/O-Gerätes.
query_io_device( : : IODeviceHandle, IOChannelName, Query : Result)
Der Operator query_io_device 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
IODeviceHandle übergeben und die Kanäle über ihre Namen in
IOChannelName adressiert. Die gewünschte Information über
die Kanäle wird mit Query spezifiziert. Eine Liste aller
unterstützten Kanalnamen erhält man, wenn Query der
Parametername 'io_channel_name' übergeben wird. Der
Parameter IOChannelName 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'.
IODeviceHandle (input_control) io_device → (handle)
Referenz auf das geöffnete I/O-Gerät.
IOChannelName (input_control) string(-array) → (string)
I/O-Kanalnamen.
Query (input_control) string-array → (string)
Abzufragende Information.
Defaultwert: 'param_name'
Werteliste: 'io_channel_names', 'param_name'
Result (output_control) string-array → (string / integer / real)
Ergebniswerte (gemäß Query).
* 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)
Sind die Parameterwerte korrekt und ist die angegebene
I/O-Schnittstelle verfügbar, liefert query_io_interface
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_info abgefragt werden kann.
Foundation