control_io_deviceT_control_io_deviceControlIoDeviceControlIoDevicecontrol_io_device (Operator)
Name
control_io_deviceT_control_io_deviceControlIoDeviceControlIoDevicecontrol_io_device — Ausführen einer Aktion auf einer I/O-Geräteinstanz.
Signatur
def control_io_device(iodevice_handle: HHandle, action: str, argument: MaybeSequence[Union[int, float, str]]) -> Sequence[Union[int, float, str]]
Beschreibung
control_io_devicecontrol_io_deviceControlIoDeviceControlIoDeviceControlIoDevicecontrol_io_device führt eine Aktion auf einer
I/O-Geräteinstanz aus. Eine ausführliche 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
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
IODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleiodevice_handle (input_control) io_device → HIODevice, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Referenz auf das geöffnete I/O-Gerät.
ActionActionActionActionactionaction (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name der auszuführenden Aktion.
ArgumentArgumentArgumentArgumentargumentargument (input_control) string(-array) → HTupleMaybeSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Argumente der auszuführenden Aktion.
Defaultwert: []
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 der ausgeführten Aktion.
Ergebnis
Im Falle gültiger Parameterwerte liefert der Operator
control_io_devicecontrol_io_deviceControlIoDeviceControlIoDeviceControlIoDevicecontrol_io_device den Wert 2 (H_MSG_TRUE). Andernfalls 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.
Vorgänger
open_io_deviceopen_io_deviceOpenIoDeviceOpenIoDeviceOpenIoDeviceopen_io_device
Modul
Foundation