VISA常用函数.doc

函数 viOpenDefaultRM 原型 Status viOpenDefaultRM (ViSession sesn ); 描述 这个函数用来初始化一个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 原型 iStatus viOpen (ViSession sesn, ViRsrc rsrcName, ViAccessMode accessMode, ViUInt32 timeout, ViSession vi); 描述 连接一个指定的设备，返回一个可用于调用其他功能的连接标识符。 参数 名称 方向 类型 描述 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 原型 iStatus viClose(ViSession vi); ViStatus viClose(ViEvent vi); ViStatus viClose(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 原型 iStatus viFindRsrc(ViSession sesn, ViString expr, ViPFindList findList, ViPUInt32 retcnt, ViRsrc instrDesc); 描述 该函数用于查找VISA系统里与指定接口相连的资源设备。该函数查找的与expr参数相匹配的有效资源设备。 该函数成功完成将返回与exor相匹配的资源组中的第一个资源（instrDesc），还返回一个资源组中的个数（retnt）。 另外还返回一个找到的队列句柄，可以同过调用viFindNext传入这个句柄