VISA常用函数(必威体育精装版整理版).docx

实用文档

函数

viOpenDefaultRM

原型

ViStatusviOpenDefaultRM(ViSessionsesn);

描述

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

参数

名称

方向

类型

描述

sesn

OUT

ViSession

返回一个独一无二的VISA资源管理器逻辑标识符

返回值

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

标识符

值

描述

VI_SUCCESS

0

VISA资源管理器初始化成功。

VI_ERROR_ALLOC

系统资源不足。

VI_ERROR_INV_SETUP

配置文件无效或者不存在。

VI_ERROR_SYSTEM_ERROR

VISA系统初始化失败。

viOpen

原型

ViStatusviOpen(ViSessionsesn,ViRsrcrsrcName,ViAccessModeaccessMode,ViUInt32timeout,ViSessionvi);

描述

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

参数

名称

方向

类型

描述

sesn

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

资源管理器sesn不支持此函数。

VI_ERROR_RSRC_BUSY

sesn是有效的，但当前无法访问。

VI_ERROR_RSRC_LOCKED

sesn被独占。

VI_ERROR_RSRC_NFOUND

信息不足或者资源不存在。

VI_ERROR_TMO

0xBFFF0015

操作超时。

viClose

原型

ViStatusviClose(ViSessionvi);

ViStatusviClose(ViEventvi);

ViStatusviClose(ViFindListvi);

描述

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

参数

名称

方向

类型

描述

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

原型

ViStatusviFindRsrc(ViSessionsesn,ViStringexpr,ViPFindListfindList,

ViPUInt32retcnt,ViRsrcinstrDesc);

描述

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

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

另外还返回一个找到的队列句柄，可以同过调用viFindNext传入这个句柄来获得其他找到的资