PXI-0361函数说明.pdf

PXI-0361 驱动程序函数说明 内容提要 本说明书给出 PXI-0361 的PnP 驱动程序中所有的 API 函数的详细说明。函 数说明以 C/C++ 的语法给出，包括参数说明和返回值。PXI-0361 的PnP 驱动程 序按 PnP 规范规定，在 Windows 平台下以标准.DLL 的方式提供，其他的开发工 具也可调用。 调用PnP API 函数前的准备 PXI-0361 的驱动程序是基于华太测控VISA 环境的。在调用这些 API 函数前， 以下条件必须满足：  仪器模块已在 PXI 主机箱中安装并设置好  零槽控制器安装并设置好  有关软件已安装并设置好  底层驱动程序已经安装 函数说明 PXI0361_init ViStatus PXI0361_init (ViRsrc resource_name, ViBoolean id_query, ViBoolean reset_device, ViPSession instrument_handle); 目的 初始化函数使软件与仪器模块连接并判断仪器模块是否在系统中。 另外，它还可以完成一些必要的操作使模块处于复位的状态。 初始化函数如果成功，将返回一模块handle。该模块handle在以后的操 作中使用。 如果失败，将返回一错误码。 参数列表 resource_name 变量类型 ViRsrc 仪器模块的描述，例如： "PXI::4::INSTR" 根据指定的枚举顺序连接模块 "PXI::ID4::INSTR" 根据指定模块的唯一ID，连接模块 "GPIB-VXI0::3::INSTR" 连接逻辑地址3的模块(GPIB零槽) "GPIB0::7::2::INSTR" 连接逻辑地址7的模块(GPIB零槽原地址为2) id_query 变量类型 ViBoolean 指定是否对模块进行ID校验。 ID查询是校验有相同类型代码和厂家ID的模块。 有效值为: VI_TRUE 进行系统校验 VI_FALSE 不进行系统校验 reset_device 变量类型 ViBoolean 指定是否在初始化时对模块进行复位操作。 有效值为: VI_TRUE 进行复位操作 VI_FALSE 不进行复位操作 instrument_handle 变量类型 ViSession (passed by reference) 返回一个模块handle。该模块handle在以后的操作中使用。 一旦初始化成功，模块 handle 将一直被使用直到调用 close 函数关 闭 模块handle。如果初始化失败则返回值为VI_NULL。 返回值 返回初始化函数状态值。 如果成功，返回0或大于0的整数。 如果出错，返回负数。可以调用error_message函数把负数转换成