描述 从语法上分析一个指向设备的资源字符串。这操作分析字符串的有效性。viFindRsrc函数返回的所有字符串都必须
在分析成功后才能调用viOpen函数。
返回的intfType和intfNum分别对应VI_ATTR_INTF_TYPE和VI_ATTR_INTF_NUM属性。这些值将与使用viOpen
函数连接后使用viGetAttribute函数查询的值一样。
在viOpen函数中设置别名,viParesRsrc函数也能识别。
rsrcName参数不区分大小写。
参数
名称 方向 类型 描述
sesn IN ViSession
默认资源管理器(必须经过viOpenDefaultRM函数初始化)。
rsrcName IN ViRsrc
资源独立的名称。
intfType OUT ViPUInt16
会话连接的接口类型。
intfNum OUT ViPUInt16
会话连接的板号。
返回值 返回值为函数运行结果。
标识符 值 描述
VI_SUCCESS 0
资源字符串是有效的。
VI_ERROR_ALLOC
内存不足。
VI_ERROR_INTF_NUM_NCONFIG
接口类型是有效的,但接口号是无效的。
VI_ERROR_INV_RSRC_NAME
无效的资源指示字符串。语法错误。
VI_ERROR_INV_SESSION
VI_ERROR_INV_OBJECT
sesn不能标志正确的连接。
VI_ERROR_LIBRARY_NFOUND
一个VISA必须库无法加载。
VI_ERROR_NSUP_OPER
给定的sesn不支持该函数。例如,该函数仅仅支持默认资源管
理器的sesn。
VI_ERROR_RSRC_NFOUND
位置信息不足。
viClear
原型
ViStatus viClear(ViSession vi);
描述 清空设备,执行IEEE 488.1系统的清空操作。
如果连接方式是使用VXI总线,将清空所有连接设备;
如果连接方式是使用GPIB数据采集板,将只清空指定地址的设备;
如果连接方式是使用TCPIP套接字,需要把VI_ATTR_IO_PROT属性设置成VI_PROT_4882_STRS,将相当于向设
备发送”*CLS\n”字符串,其他设置操作无效。
参数
名称 方向 类型 描述
vi IN ViSession 对象标识符。
返回值 返回值为函数运行结果。