query_io_deviceT_query_io_deviceQueryIoDeviceQueryIoDevicequery_io_device (Operator)

Name

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

Signatur

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

Herror T_query_io_device(const Htuple IODeviceHandle, const Htuple IOChannelName, const Htuple Query, Htuple* Result)

void QueryIoDevice(const HTuple& IODeviceHandle, const HTuple& IOChannelName, const HTuple& Query, HTuple* Result)

HTuple HIODevice::QueryIoDevice(const HTuple& IOChannelName, const HTuple& Query) const

HTuple HIODevice::QueryIoDevice(const HString& IOChannelName, const HTuple& Query) const

HTuple HIODevice::QueryIoDevice(const char* IOChannelName, const HTuple& Query) const

HTuple HIODevice::QueryIoDevice(const wchar_t* IOChannelName, const HTuple& Query) const   (Nur Windows)

static void HOperatorSet.QueryIoDevice(HTuple IODeviceHandle, HTuple IOChannelName, HTuple query, out HTuple result)

HTuple HIODevice.QueryIoDevice(HTuple IOChannelName, HTuple query)

HTuple HIODevice.QueryIoDevice(string IOChannelName, HTuple query)

def query_io_device(iodevice_handle: HHandle, iochannel_name: MaybeSequence[str], query: Sequence[str]) -> Sequence[Union[int, float, str]]

Beschreibung

Der Operator query_io_devicequery_io_deviceQueryIoDeviceQueryIoDeviceQueryIoDevicequery_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 IODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleiodevice_handle übergeben und die Kanäle über ihre Namen in IOChannelNameIOChannelNameIOChannelNameIOChannelNameIOChannelNameiochannel_name 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 IOChannelNameIOChannelNameIOChannelNameIOChannelNameIOChannelNameiochannel_name 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.

Ausführungsinformationen

Parameter

IODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleiodevice_handle (input_control)  io_device HIODevice, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

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

IOChannelNameIOChannelNameIOChannelNameIOChannelNameIOChannelNameiochannel_name (input_control)  string(-array) HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

I/O-Kanalnamen.

QueryQueryQueryQueryqueryquery (input_control)  string-array HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)

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 HTupleSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)

Ergebniswerte (gemäß 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_interfaceQueryIoInterfaceQueryIoInterfaceQueryIoInterfacequery_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_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info abgefragt werden kann.

Nachfolger

open_io_deviceopen_io_deviceOpenIoDeviceOpenIoDeviceOpenIoDeviceopen_io_device

Modul

Foundation