query_io_interfaceT_query_io_interfaceQueryIoInterfaceQueryIoInterfacequery_io_interface (算子名称)

名称

query_io_interfaceT_query_io_interfaceQueryIoInterfaceQueryIoInterfacequery_io_interface — Query information about the specified I/O device interface.

参数签名

query_io_interface( : : IOInterfaceName, Query : Result)

Herror T_query_io_interface(const Htuple IOInterfaceName, const Htuple Query, Htuple* Result)

void QueryIoInterface(const HTuple& IOInterfaceName, const HTuple& Query, HTuple* Result)

static HTuple HIODevice::QueryIoInterface(const HString& IOInterfaceName, const HTuple& Query)

static HTuple HIODevice::QueryIoInterface(const HString& IOInterfaceName, const HString& Query)

static HTuple HIODevice::QueryIoInterface(const char* IOInterfaceName, const char* Query)

static HTuple HIODevice::QueryIoInterface(const wchar_t* IOInterfaceName, const wchar_t* Query)   ( Windows only)

static void HOperatorSet.QueryIoInterface(HTuple IOInterfaceName, HTuple query, out HTuple result)

static HTuple HIODevice.QueryIoInterface(string IOInterfaceName, HTuple query)

static HTuple HIODevice.QueryIoInterface(string IOInterfaceName, string query)

def query_io_interface(iointerface_name: str, query: MaybeSequence[str]) -> Sequence[Union[int, float, str]]

描述

该算子 query_io_interfacequery_io_interfaceQueryIoInterfaceQueryIoInterfaceQueryIoInterfacequery_io_interface returns information about the I/O device interface IOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceNameiointerface_name. The desired information is specified via QueryQueryQueryQueryqueryquery. If applicable, ResultResultResultResultresultresult contains a list of supported values.

Generally, when passing the value 'interface_name'"interface_name""interface_name""interface_name""interface_name""interface_name" for QueryQueryQueryQueryqueryquery, all available I/O interfaces are returned. The value of the parameter IOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceNameIOInterfaceNameiointerface_name is ignored in this case.

Please check the directory doc/html/reference/io for documentation about your specific I/O device interface, where all supported interface specific parameters are listed.

注意

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 (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

HALCON I/O interface name.

Default: []

Suggested values: '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"

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

Parameter name of the query.

Default: 'io_device_names' "io_device_names" "io_device_names" "io_device_names" "io_device_names" "io_device_names"

Suggested values: 'interface_name'"interface_name""interface_name""interface_name""interface_name""interface_name", 'io_device_names'"io_device_names""io_device_names""io_device_names""io_device_names""io_device_names", 'param_name'"param_name""param_name""param_name""param_name""param_name", 'revision'"revision""revision""revision""revision""revision"

ResultResultResultResultresultresult (output_control)  string-array HTupleSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)

List of result values (according to QueryQueryQueryQueryqueryquery).

例程 (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)

结果

如果参数均有效,算子 query_io_interfacequery_io_interfaceQueryIoInterfaceQueryIoInterfaceQueryIoInterfacequery_io_interface 返回值 2 ( H_MSG_TRUE) . If necessary an exception is raised. In this case, an extended error information may be set and can be queried with 该算子 get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info.

可能的后置算子

open_io_deviceopen_io_deviceOpenIoDeviceOpenIoDeviceOpenIoDeviceopen_io_device

模块

Foundation