control_io_deviceT_control_io_deviceControlIoDeviceControlIoDevicecontrol_io_device控制输入输出设备（算子）
名称
control_io_deviceT_control_io_deviceControlIoDeviceControlIoDevicecontrol_io_device — 在输入/输出设备上执行操作。
签名
def control_io_device(iodevice_handle: HHandle, action: str, argument: MaybeSequence[Union[int, float, str]]) -> Sequence[Union[int, float, str]]
描述
control_io_devicecontrol_io_deviceControlIoDeviceControlIoDeviceControlIoDevicecontrol_io_device 对 I/O 设备执行操作。支持的参数因接口而异，具体列表详见所用 I/O 接口的对应文档，该文档位于 doc/html/reference/io 目录中。
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
参数
IODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleiodevice_handle (输入控制) io_device → HIODevice, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
已打开 I/O 设备的句柄。
ActionActionActionActionactionaction (输入控制) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
要执行的操作名称。
ArgumentArgumentArgumentArgumentargumentargument (输入控制) string(-array) → HTupleMaybeSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
操作的参数列表。
默认值：
[]
ResultResultResultResultresultresult (输出控制) string-array → HTupleSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
操作返回的结果值列表。
结果
如果参数有效，算子 control_io_devicecontrol_io_deviceControlIoDeviceControlIoDeviceControlIoDevicecontrol_io_device 返回值 2 (H_MSG_TRUE)。如有必要，则抛出异常。在此情况下，可设置扩展错误信息，并可通过算子 get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info 进行查询。
可能的前趋
open_io_deviceopen_io_deviceOpenIoDeviceOpenIoDeviceOpenIoDeviceopen_io_device
模块
基础