首页 > 美文鉴赏

VISA常用函数

更新时间:2023-07-19 23:20:34 阅读：评论：0

函数

viOpenDefaultRM

原型

ViStatus viOpenDefaultRM (ViSession sn );

描述

这个函数用来初始化一个VISA资源管理器，此函数必须要在其他任何VISA函数之前调用。函数通过sn参数返回一个独立的VISA资源管理器ID。

参数

名称	方向	类型	描述
sn	OUT	ViSession	返回一个独一无二的VISA资源管理器逻辑标识符

返回值

返回值为函数运行结果，如果成功sn返回VISA资源管理器标识符，否则返回0。

标识符	值	描述
VI_SUCCESS	0	VISA资源管理器初始化成功。
VI_ERROR_ALLOC		系统资源不足。
VI_ERROR_INV_SETUP		配置文件无效或者不存在。
VI_ERROR_SYSTEM_ERROR		VISA系统初始化失败。

viOpen

原型

ViStatus viOpen (ViSession sn, ViRsrc rsrcName, ViAccessMode accessMode, ViUInt32 timeout, ViSession vi);

描述

连接一个指定的设备，返回一个可用于调用其他功能的连接标识符。

参数

名称	方向	类型	描述
sn	IN	ViSession	VISA资源管理器逻辑标识符。
rsrcName	IN	ViRsrc	地址名称。
accessMode	IN	ViAccessMode	连接打开方式，可以是以下值： VI_EXCLUSIVE_LOCK带月的诗词独占方式打开； VI_LOAD_CONFIG更具外部配置文件打开； VI_NULL正常多访问打开。
timeout	IN	ViUInt32	如果是以独占模式连接，该参数是一个绝对时间（单位ms），超时就返回一个错误。其他连接方式忽略此值。
vi	谏山冥 OUT	ViSession	返回打开连接逻辑标识符。

返回值

返回值为函数运行结果，如果成功vi返回设备连接标识符，否则返回0。

标识符	值	描述
VI_SUCCESS	0	连接成功。
VI_SUCCESS_DEV_NPRESENT		连接成功。但是指定的地址无响应。
VI_WARN_CONFIG_NLOADED		指定的地址不存在或者地址格式不正确。
VI_ERROR_ALLOC		系统资源不足。
VI_ERROR_INTF_NUM_NCONFIG		指定的地址是有效的，但无法使用。
VI_ERROR_INV_ACC_MODE		非法的存取模式。
VI_ERROR_INV_RSRC_NAME		地址名称语法错误。
VI_ERROR_INV_SESSION VI_ERROR_INV_OBJECT		无效的vi。
VI_ERROR_LIBRARY_NFOUND		VISA库加载不完全。
VI_ERROR_NSUP_OPER		资源管理器sn不支持此函数。
VI_ERROR_RSRC_BUSY		sn是有效的，但当前无法访问。
VI_ERROR_RSRC_LOCKED		sn被独占。
VI_ERROR_RSRC_NFOUND		信息不足或者资源不存在。
VI_ERROR_TMO	0xBFFF0015	操作超时。

viClo

原型

ViStatus viClo(ViSession vi);

ViStatus viClo(ViEvent vi);

ViStatus viClo(ViFindList vi);

描述

短袖的英语

关闭一个资源管理器或者设备连接，并释放内存。

参数

名称	方向	类型团支书竞选演讲	描述
vi	IN	ViSession ViEvent ViFindList	需要关闭的对象。

返回值

返回值为函数运行结果。

欧美校园电影

标识符	值	描述
VI_SUCCESS	0	关闭成功。
VI_WARN_NULL_OBJECT		要关闭的对象是空对象。
VI_ERROR_CLOSING_FAILED		vi不能标识正当对话通道。
VI_ERROR_INV_SESSION VI_ERROR_INV_OBJECT		无法释放与该对话通道相关联的内存数据结构。

给猫洗澡

viFindRsrc

原型

ViStatus viFindRsrc(ViSession sn, ViString expr, ViPFindList findList,

ViPUInt32 retcnt, ViRsrc instrDesc);

描述

该函数用于查找VISA系统里与指定接口相连的资源设备。该函数查找的与expr参数相匹配的有效资源设备。

该函数成功完成将返回与exor相匹配的资源组中的第一个资源（instrDesc），还返回一个资源组中的个数（retnt）。

另外还返回一个找到的队列句柄，可以同过调用viFindNext传入这个句柄来获得其他找到的资源。当这个句柄不需要时必须调用viClo关闭。

expr参数不区分大小写，搜寻标准由两个部分组成：一个资源的正则表达式和一个可选的属性值逻辑表达式。这个正则表达式是与已知的VISA资源管理器相匹配。

如果这资源字符串与正则表达式相匹配，并且属性值也与逻辑表达式匹配，则这匹配是成功的，这资源将添加到资源查询队列（findList）中。（安捷伦的VISA不支持匹配属性值。）

这可选的属性逻辑表达式允许使用逻辑符号AND，OR，NOT。相等（==）和不等（!=）可以用与任何类型的属性比较。另外的非等号比较的（>，<，>=，<=）只能用于数值类型的属性比较。仅仅全局属性才能参与属性表达式。

如果findList参数传入的是VI_NULL，则会自动调用viClo关闭查找到的资源队列。findList参数和retcnt参数都是可选的，如果只需要第一个匹配到的设备并且不需要知道连接了多少设备这两个参数都可以传入VI_NULL。

所有返回的字符串都需要经过viParRsrc和viOpen函数的验证，不是所有查询到的资源都可以通过和查询的。

参数

名称	方向	类型	描述
sn	IN	ViSession	资源管理器。必须要被viOpenDefaultRM函数初始化。
expr	IN	ViString	表达要搜索的一个接口或者所有接口存在的设备。（参照下面的格式描述字符串表）
findList	OUT	ViPFindList	返回一个搜索到的句柄标识符，这句柄可以作为viFindNext函数的参数传入。如果为VI_NULL，自动动调用viClo关闭findList。
retcnt	OUT	ViPUInt32	匹配到的设备数量。如果为VI_NULL，不返回找到的个数。
instrDesc	徐志摩的爱情诗OUT	ViRsrc	返回一个设备识别地址字符串，可以直接传给viOpen建立一个会话。

expr参数描述字符串说明：

接口	表达
GPIB	GPIB[0-9]::?INSTR
VXI	VXI?*INSTR
GPIB-VXI	GPIB-VXI?*INSTR
GPIB和GPIB-VXI	GPIB?*INSTR
All VXI	?VXI[0-9]::?*INSTR
ASRL	ASRL[0-9]::?INSTR
All	?*INSTR

返回值

返回值为函数运行结果。

标识符	值	描述
VI_SUCCESS	0	找到资源。
VI_ERROR_INV_SESSION VI_ERROR_INV_OBJECT		传递的对象无效。
VI_ERROR_NSUP_OPER		不支持该函数。
VI_ERROR_INV_EXPR		无效的搜索指定。
VI_ERROR_RSRC_NFOUND		没有找到设备。

viFindNext

原型

ViStatus viFindNext(ViFindList findList, ViPRsrc instrDesc);

描述

返回查找资源队列上的下一个资源。

参数

名称	方向	类型	描述
findList	IN	ViFindList	查找队列句柄。必须由viFindRsrc函数创建。
instrDesc	OUT	ViPRsrc	返回一个地址字符串。字符串可以通过调用viOpen函数建立一个会话连接。

返回值

返回值为函数运行结果。

标识符	值	描述
VI_SUCCESS	0	找到资源。
VI_ERROR_INV_SESSION VI_ERROR_INV_OBJECT		findList不能标志正确的连接。
VI_ERROR_NSUP_OPER		findList不支持该函数。
VI_ERROR_RSRC_NFOUND		没找到资源。

viParRsrc

原型

ViStatus viParRsrc(ViSession sn, ViRsrc rsrcName, ViPUInt16 intfType, ViPUInt16 intfNum);

描述

从语法上分析一个指向设备的资源字符串。这操作分析字符串的有效性。viFindRsrc函数返回的所有字符串都必须在分析成功后才能调用viOpen函数。

返回的intfType和intfNum分别对应VI_ATTR_INTF_TYPE和VI_ATTR_INTF_NUM属性。这些值将与使用viOpen函数连接后使用viGetAttribute函数查询的值一样。

在viOpen函数中设置别名，viParesRsrc函数也能识别。

rsrcName参数不区分大小写。

参数

名称	方向	类型	描述
sn	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		sn不能标志正确的连接。
VI_ERROR_LIBRARY_NFOUND		一个VISA必须库无法加载。
VI_ERROR_NSUP_OPER		给定的公众号视频怎么下载sn不支持该函数。例如，该函数仅仅支持默认资源管理器的sn。
VI_ERROR_RSRC_NFOUND		位置信息不足。

本文发布于:2023-07-19 23:20:34，感谢您对本站的认可！

本文链接：https://www.wtabcd.cn/fanwen/fan/89/1088342.html

上一篇：Morgan Stanley 金融词汇表

下一篇：保护动物英语作文80词

标签：函数资源连接返回设备

留言与评论（共有 0 条评论）