第三章 虚拟仪器系统IO接口软件(4)

型的设置只对于独占锁定状态有关，所有非独占性锁定状态均为共享。 5） 相关项：参见viUnLock（）、viUnLockRsrc（）。

6） 实现要求：当锁定模式为非独占型时，shareType参数可忽略。 10、 viUnLock（vi，lockId）

viUnLockRsrc（vi，rsrcName，lockId） 1） 目标：取消资源存取模式 2） 参数表：

参数名 输入/输出方向 数据类型 描述

vi 输入 ViSession 对话通道标识符（句柄） rsrcName 输入 ViRsrc 资源名 lockId 输入 ViLock 锁定标识符 3） 返回状态值： 完成代码：

VI_SUCCESS 取消锁定模式完成

VI_WARN_NON_EXCLUSIVE 调用成功，但资源仍被非独占型锁定 _LOCK

VI_WARN_EXCLUSIVE_LOCK 调用成功，但资源仍被独占型锁定 错误代码：

VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_INV_LOCK_ID 锁定标识符不当

VI_ERROR_LOCK_NOWNER 锁定并非来自于特定通道vi 4） 描述：该操作用于取消以前设置的资源锁定模式。 5） 相关项：参见viLock（）、viLockRsrc（）。

6） 实现要求：注意不同的参数输入对应于不同的返回状态。 11、 viEnableEvent（vi，eventType，mechanism，context） 1） 目标：允许特定事件通知 2） 参数表：

参数名 输入/输出方向 数据类型 描述

vi 输入 ViSession 对话通道标识符（句柄） eventType 输入 ViEventType 事件标识符 mechanism 输入 ViUInt16 事件处理机制 context 输入 ViEvent 事件信息 3） 返回状态值： 完成代码：

VI_SUCCESS 事件通知允许

VI_SUCCESS_EVENT_EN 至少一种事件处理机制被允许 错误代码：

VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_INV_EVENT 特定事件不存在或不被支持 VI_ERROR_INV_MECH 事件处理机制不合法

VI_ERROR_HNDLR_NINSTALLED 特定事件句柄未被安装

4） 描述：该操作允许特定事件的通知，应用程序可采用事件排队或回调（中断）

方式处理该事件。

5） 相关项：参见viEventHandler（）、viInstallHandler（）、 viUnInstallHandler（）。

6） 实现要求：若事件句柄未被安装，则在回调（中断）方式中返回错误值。 12、 viDisableEvent（vi，eventType，mechanism） 1） 目标：不允许特定事件通知 2） 参数表：

参数名 输入/输出方向 数据类型 描述

vi 输入 ViSession 对话通道标识符（句柄） eventType 输入 ViEventType 事件标识符 mechanism 输入 ViUInt16 事件处理机制 3） 返回状态值： 完成代码：

VI_SUCCESS 事件通知不允许

VI_SUCCESS_EVENT_DIS 至少一种事件处理机制不被允许 错误代码：

VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_INV_EVENT 特定事件不存在或不被支持 VI_ERROR_INV_MECH 事件处理机制不合法 4） 描述：该操作取消特定事件的服务通知。

5） 相关项：参见viEventHandler（）、viInstallHandler（）、 viUnInstallHandler（）。

6） 实现要求：若一个对话通道上的事件处理机制不允许，事件登录还将保留。 13、 viQueryEventMech（vi，eventType，mechanism） 1） 目标：查询事件处理机制 2） 参数表：

参数名 输入/输出方向 数据类型 描述

vi 输入 ViSession 对话通道标识符（句柄） eventType 输入 ViEventType 事件标识符 mechanism 输出 ViUInt16 事件处理机制 3） 返回状态值： 完成代码：

VI_SUCCESS 事件查询完成 错误代码：

VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_INV_EVENT 特定事件不存在或不被支持

4） 描述：该操作查询特定事件处理机制，所有事件处理机制返回值以“位或”操 作值形式给出。

5） 相关项：参见viEventHandler（）、viInstallHandler（）、 viUnInstallHandler（）。 6） 实现要求：无。

14、 viInstallHandler（vi，eventType，handler，userHandle）

1） 目标：安装事件回调句柄 2） 参数表：

参数名 输入/输出方向 数据类型 描述

vi 输入 ViSession 对话通道标识符（句柄） eventType 输入 ViEventType 事件标识符 handler 输入 ViHndlr 应用程序中的事件句柄 userHandle 输入 ViAddr 事件句柄值 3） 返回状态值： 完成代码：

VI_SUCCESS 安装事件句柄完成 错误代码：

VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_INV_EVENT 特定事件不存在或不被支持

4） 描述：该操作允许应用程序去安装事件处理句柄，句柄由输入参数handler唯 一确定，事件类型包括资源事件（VI_RSRC_EVENT）、系统事件(VI_SYS_EVENT)、 异常事件（VI_EXCEPTION），当事件类型参数设为所有事件(VI_ALL_EVENTS)时， 以上三种类型事件句柄均被设置。

5） 相关项：参见viEventHandler（）、viUnInstallHandler（）。 6） 实现要求：无。

15、 viUninstallHandler（vi，eventType，handler，userHandle） 1） 目标：卸载事件回调句柄 2） 参数表：

参数名 输入/输出方向 数据类型 描述

vi 输入 ViSession 对话通道标识符（句柄） eventType 输入 ViEventType 事件标识符 handler 输入 ViHndlr 应用程序中的事件句柄 userhandle 输入 ViAddr 事件句柄值 3） 返回状态值： 完成代码：

VI_SUCCESS 卸载事件句柄完成 错误代码：

VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_INV_EVENT 特定事件不存在或不被支持

VI_ERROR_INV_HNDLR_REF 句柄参数与所有已安装的句柄不匹配

4） 描述：该操作允许应用程序去卸载事件处理句柄，句柄由输入参数handler唯 一确定，事件类型包括资源事件（VI_RSRC_EVENT）、系统事件(VI_SYS_EVENT)、 异常事件（VI_EXCEPTION），当事件类型参数设为所有事件(VI_ALL_EVENTS)时， 以上三种类型事件句柄均被卸载。

4） 相关项：参见viEventHandler（）、viEnableEvent（）。 5） 实现要求：卸装的句柄一定要先安装。

16、 viQueryHandlers（vi，eventType，handlers，userHandle） 1） 目标：查询事件已安装句柄

2） 参数表：

参数名 输入/输出方向 数据类型 描述

vi 输入 ViSession 对话通道标识符（句柄） eventType 输入 ViEventType 事件标识符

handlers 输出 ViPHndlr 应用程序中的事件句柄 userHandle 输出 ViAddr 事件句柄值 3） 返回状态值： 完成代码：

VI_SUCCESS 查询事件句柄完成 错误代码：

VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_INV_EVENT 特定事件不存在或不被支持