control_io_interfaceT_control_io_interfaceControlIoInterfaceControlIoInterfacecontrol_io_interface (算子)
名称
control_io_interfaceT_control_io_interfaceControlIoInterfaceControlIoInterfacecontrol_io_interface — 在输入/输出接口上执行操作。
签名
void ControlIoInterface(const HTuple& IOInterfaceName, const HTuple& Action, const HTuple& Argument, HTuple* Result)
static HTuple HIODevice::ControlIoInterface(const HString& IOInterfaceName, const HString& Action, const HTuple& Argument)
static HTuple HIODevice::ControlIoInterface(const HString& IOInterfaceName, const HString& Action, const HString& Argument)
static HTuple HIODevice::ControlIoInterface(const char* IOInterfaceName, const char* Action, const char* Argument)
static HTuple HIODevice::ControlIoInterface(const wchar_t* IOInterfaceName, const wchar_t* Action, const wchar_t* Argument)
(
Windows only)
描述
control_io_interfacecontrol_io_interfaceControlIoInterfaceControlIoInterfaceControlIoInterfacecontrol_io_interface performs an action on the I/O
interface. The supported parameters are interface-specific and
listed in the corresponding documentation of the used I/O interface
that can be found in the directory doc/html/reference/io.
The special value 'keep_open'"keep_open""keep_open""keep_open""keep_open""keep_open" for ActionActionActionActionactionaction is used to
control when the interface should be unloaded. If ArgumentArgumentArgumentArgumentargumentargument is set
to 'true'"true""true""true""true""true", the interface will remain loaded until the HALCON
process is terminated. If it is set to 'false'"false""false""false""false""false", the interface will
be unloaded as soon as all its device instances are closed. This is the
default behavior.
注意
On Windows Systems, error dialog boxes from the operating system can occur
when dependency modules of the interface are not found, e.g., the according
SDK was not installed. The occurrence of the error boxes can be controlled by
setting Windows' Error Mode. Please refer to the description of SetErrorMode
within the Windows MSDN documentation.
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
参数
IOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceNameiointerface_name (输入控制) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
HALCON I/O interface name.
默认值：
[]
建议值：
'ADLINK-DAQPilot'"ADLINK-DAQPilot""ADLINK-DAQPilot""ADLINK-DAQPilot""ADLINK-DAQPilot""ADLINK-DAQPilot", 'ADLINK-EOS'"ADLINK-EOS""ADLINK-EOS""ADLINK-EOS""ADLINK-EOS""ADLINK-EOS", 'Advantech'"Advantech""Advantech""Advantech""Advantech""Advantech", 'Contec'"Contec""Contec""Contec""Contec""Contec", 'Hilscher-cifX'"Hilscher-cifX""Hilscher-cifX""Hilscher-cifX""Hilscher-cifX""Hilscher-cifX", 'Interface'"Interface""Interface""Interface""Interface""Interface", 'Linux-GPIO'"Linux-GPIO""Linux-GPIO""Linux-GPIO""Linux-GPIO""Linux-GPIO", 'NIDAQmx'"NIDAQmx""NIDAQmx""NIDAQmx""NIDAQmx""NIDAQmx", 'OPC_Classic'"OPC_Classic""OPC_Classic""OPC_Classic""OPC_Classic""OPC_Classic", 'OPC_UA'"OPC_UA""OPC_UA""OPC_UA""OPC_UA""OPC_UA"
ActionActionActionActionactionaction (输入控制) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name of the action to perform.
ArgumentArgumentArgumentArgumentargumentargument (输入控制) string(-array) → HTupleMaybeSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
List of arguments for the action.
默认值：
[]
ResultResultResultResultresultresult (输出控制) string-array → HTupleSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
List of results returned by the action.
结果
如果参数有效，算子 control_io_interfacecontrol_io_interfaceControlIoInterfaceControlIoInterfaceControlIoInterfacecontrol_io_interface 返回值 2 ( H_MSG_TRUE )。如有必要，则抛出异常。 In this
case an extended error information may be set and can be queried with
the operator get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info。
另见
query_io_interfacequery_io_interfaceQueryIoInterfaceQueryIoInterfaceQueryIoInterfacequery_io_interface
模块
基础