第1页 / 共10页
第2页 / 共10页
第3页 / 共10页
第4页 / 共10页
第5页 / 共10页
第6页 / 共10页
第7页 / 共10页
第8页 / 共10页
Labview 动态链接库调用.pdf
该文档版权归上海微视泰科工作室所有，转载请注明出处!
网址：http://www.microvt.com
Email: hightechyoung@yahoo.com
作者：HighTech Young
6.3. 调用动态链接库(DLL)
相对于 CIN 来讲，NI 更推荐用户使用 DLL 来共享基于文本编程语言开发的代码。除了共享或重复利用
代码，开发人员还能利用 DLL 封装软件的功能模块，以便这些模块能被不同开发工具利用。在 LabVIEW 中
使用 DLL 一般有以下几种途径：
1. 使用自己开发 DLL 中的函数。
2. 调用操作系统或硬件驱动供应商提供的 API。
对于前一种方法来说，又可以通过以下几步来实现：
a) 在 LabVIEW 中定义 DLL 原型；
b) 生成.C 或.C++文件，完成实现函数功能的代码并为函数添加 DLL 导出声明；
c) 通过外部 IDE（如 VC++）创建 DLL 项目并编译生成.dll 文件。
d) 在 LabVIEW 项目中使用 DLL 中的函数。
以下章节将通过实例对这两种情况详细进行叙述。
6.3.1. 配置 Call Library Function Node(CFN)
无论在 LabVIEW 中使用自己开发的 DLL，硬件驱动供应商或者操作系统提供的 API，都可以通过
配置 Call Library Function Node (CFN，图 6-12)来完成。
图 6-12 LabVIEW 的 Call Library Function Node
在 CFN 图标的右键菜单上选择“Configure…”打开 Call Library Function 配置对话框(图 6-13)。
通过该对话框，可以指定动态库存放路径、调用的函数名以及传递给函数的参数类型和函数返回值的类
型。在配置完后，CLF 节点会根据用户的配置自动更新其显示。
通过 Browse 按钮或者直接在“Library Name or Path”输入框中指定调用函数多在.dll 文件的路
径。
通过 Browse 按钮下的控件用户可以指定多个线程同时调用 DLL。默认情况下，LabVIEW 以“Run
11
该文档版权归上海微视泰科工作室所有，转载请注明出处!
网址：http://www.microvt.com
Email: hightechyoung@yahoo.com
作者：HighTech Young
in UI Thread”方式调用 DLL，调用的函数将直接在用户线程中运行。另外一种方式为递归方式
“Reentrant”，在这种情况下可以允许多个线程同时调用 DLL 中的函数。但要确保正常调用，必须使
DLL 中的代码线程安全。以下是一些最基本的线程安全特性：
a. 代码不含有未受保护的全局数据（如全局变量，文件）；
b. 代码不访问硬件（即不含有寄存器一级的代码）；
c. 代码不调用非线程安全的函数、DLL 或者驱动；
d. 代码使用信号量或者互斥量来保护全局量；
e. 代码被一个非递归的 VI 调用时为线程安全。
图 6-13 CLF 配置对话框
在“Function Name”输入框中指定要调用函数的函数名。
通过“Call Conventions”下拉列表框指定调用 DLL 中函数的方式。可以指定调用方式为“C”（默认方
式）或 Windows 标准调用方式“stdcall”。一般来说用“C”方式调用开发人员自己写的 DLL 函数，而 “stdcall”
一般做为标准调用方式来调用 windows 的 API
通过 Parameter 域可以指定所调用函数的返回值类型。默认情况下 CFN 节点没有输入参数而且只有一
个 void 类型的返回参数。该参数由 CFN 节点第一对连接点的右端返回，代表 CFN 执行结果。如果返回参数
的类型是 void 类型，则 CFN 连接点为未启用状态（保持为灰色）。CFN 的每一对连接点代表一个输入或输
出参数，若要传递参数给 CFN 则将参数连接至相应连接点的左端，若要读取返回值，则将相应连接点的右端
连接到 Indicator。
CFN 返回参数的类型可以是 Void，Numeric 或 String。只能为返回参数指定 Void 类型，输入参数不能
指定为 Void 类型。调用的函数没有返回值时，指定 CFN 的返回参数类型为 void 类型。即使参数有确定类
型的返回值，也可以指定 CFN 的返回类型为 Void，但是此时，函数的返回值将被忽略。
有些时候，调用的函数返回值不是以上三种类型，可以使用与以上三种类中有相同大小的一个来代替。
例如如果调用的函数返回一个 Char 类型数据，则可以用一个 8-bit unsigned integer 的 Numeric 类型来代
替。此外，由于 LabVIEW 中没有指针，因此调用 DLL 中的返回指针的函数似乎不可能。但是可以设定返回
值类型为一个与指针有相同大小的 Integer 类型，LabVIEW 将把地址以整型值来看待，并且用户可以在以
后的调用中直接使用它。
12
该文档版权归上海微视泰科工作室所有，转载请注明出处!
网址：http://www.microvt.com
Email: hightechyoung@yahoo.com
作者：HighTech Young
通过 Parameter 域和其右边的“Add a Parameter Before”，“Add a Parameter After” 和“Delete this
Parameter”三个按钮可以增加、删除以及修改 CFN 的输入参数和类型。当用户选择某参数的类型后，其详
细的数据类型列表和参数传递方式列表将显示出来，以方便进行详细设定。表 6-1 列出了可以设定的输入参
数类型及其详细数据类型信息。
参数类型
说明
Numeric 型参数有以下几种数据类型:
Numeric
8、16、32 和 64 位符号和无符号整型（Signed or Unsigned Integer）
4 字节单精度类型（4-byte single）
8 字节双精度类型（8-byte Double）
Array
String
Waveform
Digital Waveform
Digital Data
ActiveX
利用“Pass”下拉列表指定传递参数指针或是传递参数的指针。
Array 型参数的数据类型同 Numeric 型参数的数据类型；
通过 Dimensions 指定数组的维数；
Array Format 有以下几种选项：
Array Data Pointer 传递一维指针到数组值
Array handle 传递一个指向数组每一维的 4 个字节指针的指针，其后为数组
的值
array handle Pointer 为数组的句柄传递一个指针
用 String Format 下拉列表框选择字符串类型
C String Pointer—以 null 字符结束的字符串
Pascal String Pointer—附加长度字节的字符串
string handle—一个指向 4 个字节长度信息指针，其后为字符串的值。
string handle Pointer
Waveform 类型的参数默认类型为 8-byte double，因此一般没有必要为其指定数据
类型。但是必须为其指定维数，如果参数为单独的 Waveform，则指定 Dimensions 为
0，如果参数为 waveform 数组，则指定 Dimensions 为 1。
注意：LabVIEW 不支持超过 1D 的 waveform 数组！
如果参数为 digital waveform 数组，则指定 Dimensions 为 1,否则为 0。
注意：LabVIEW 不支持超过 1D 的 waveform 数组！
如果参数为 digital data 数组，则指定 Dimensions 为 1,否则为 0。
注意：LabVIEW 不支持超过 1D 的 digital Data 数组！
Data Type 下拉列表框有以下选择：
ActiveX Variant Pointer 传递一个指向 ActiveX 数据的指针
IDispatch* Pointer 传递一个指向 ActiveX 自动化服务器 IDispatch 接口的
指针
IUnknown Pointer 传递一个指向 ActiveX 自动化服务器 IUnknown 接口的
指针
Adapt to Type
用来传递 LabVIEW 独有的数据类型给 DLL。
表 6-2 CFN 输入参数的类型
有时可能在 CFN 配置对话框中并不能找到要传递给它的参数类型，在这种情况下可以通过下面方法来解
决。如果参数不含指针，则可以通过 Flatten to String 函数（
针传递给函数。还有其它一些技巧请参见 NI 手册。
）将参数转换为字符串，并将此字符串指
设定后的最终结果显示在“Function Prototype”文本框中，在确认前，可以在此检查设定是否正确。
如果不正确可以在此修改设定。
13
6.3.2. 调用自己开发 DLL 中的函数
该文档版权归上海微视泰科工作室所有，转载请注明出处!
网址：http://www.microvt.com
Email: hightechyoung@yahoo.com
作者：HighTech Young
开发人员可以在 LabVIEW 中指定 DLL 函数的原型，然后在外部 IDE 中完成代码并编译生成.dll 文件以
供项目使用。
下面就以一个简单的求数组求和的项目为例来说明这种开发过程。
1. 在 LabVIEW 中创建 DLL 函数原型。
a) 在 LabVIEW 的 diagram 面板上添加一个 CFN 并通过其右键菜单打开 CFN 的配置对话框；
b) 使“Library Name or Path”输入框为空；
c) 指定函数名“Function Name”和调用方式“Calling Conventions”分别为 add_num 和 C；
d) 重命名返回参数的名称为“error”，并指定其类型为 Numeric 的 Signed 32-bit Integer；
e) 用“Add a Parameter After”按钮添加第一个参数 p，指定其类型为 Array 的 4-byte Single 并
设定 Array Format 为 Array Data Pointer；
f) 用“Add a Parameter After”按钮添加第二个参数 size，指定其类型为为 Numeric 的 Signed
32-bit Integer 并设置参数传递方式为 Value；
g) 用“Add a Parameter After”按钮添加第三个参数 sum，指定其类型为为 Numeric 的 4-byte
Single 并设置参数传递方式为 Pointer to Value；
h) 至此，函数的原型应如下所示（图 6-14）：
long add_num(float *p, long size, float *sum);
图 6-14 CFN 的配置结果
i) 确定后会发现 CFN 根据配置自动进行了更新更新后的情况如右图示。
2. 生成.C 或.C++文件，完成实现函数功能的代码并为函数添加 DLL 导出声明；
在 CFN 节点上通过右键菜单选择“Create .C File…”生成 mydll.c 文件，其内容如下：
/* Call Library source file */
14
该文档版权归上海微视泰科工作室所有，转载请注明出处!
网址：http://www.microvt.com
Email: hightechyoung@yahoo.com
作者：HighTech Young
#include "extcode.h"
long add_num(float p[], long size, float *sum);
long add_num(float p[], long size, float *sum)
{
/* Insert code here */
}
将以下代码插入到/* Insert code here */句之后实现函数的功能。
for(i=0; i < size; i++)
tmpSum = tmpSum + p[i];
{
}
int i;
float tmpSum = 0;
if(p != NULL)
else
* sum = tmpSum;
return (0);
return (1);
在完成实现函数功能的代码后，还必须为函数添加导出声明以便能在 LabVIEW 中使用这些函数。
C/C++声名导出函数的关键字是_declspec (dllexport)，使用该关键字可以代替模块定义文件。
对于此处的例子来说，只要在函数声明和定义部分添加关键字即可。最终代码如下：
/* Call Library source file */
#include "extcode.h"
_declspec (dllexport) long add_num(float p[], long size, float *sum);
_declspec (dllexport) long add_num(float p[], long size, float *sum)
{
for(i=0; i < size; i++)
tmpSum = tmpSum + p[i];
/* Insert code here */
int i;
float tmpSum = 0;
if(p != NULL)
else
* sum = tmpSum;
return (0);
return (1);
{
}
}
3. 在外部 IDE（以 VC++为例）中创建 DLL 项目并编译生成.dll 文件。
用 VC++ 6.0 进行编译生成.dll 文件的步骤如下：
a) 在 VC++ 中 创 建 一 个 DLL 项 目 ， 如 果 在 DLL 中 没 有 使 用 MFC 就 选 择 创 建 “ Win32
15
该文档版权归上海微视泰科工作室所有，转载请注明出处!
网址：http://www.microvt.com
Email: hightechyoung@yahoo.com
作者：HighTech Young
Dynamic-Link Library”，否则选择“MFC AppWizard(dll)”，对此例子来说选择前者。选定后
进入下一步选择创建一个空的 DLL 项目。
b) 通过 Project»Add to Project»Files 添加 mydll.c 到创建的 mydll 项目之中
c) 通过 Project»Settings 打开项目配置对话框，选择 C/C++选项卡。
d) 配置项目的 All Configurations。选择 Settings For 下拉列表框中的 All Configurations，选择
Category 下拉列表框中的 Code Generation，最后设置 Struct member alignment 为 1 Byte。
配置结果如图 6-15。
图 6-15 配置项目的 All Configurations
e) 配置项目的 Release 版本。选择 Settings For 下拉列表框中的 Win32 Release，选择 Category
下拉列表框中的 Code Generation，最后从 Use run-time library 下拉列表框中选择
Multithreaded DLL。配置结果如图 6-16。
f) 配置项目的 Debug 版本。选择 Settings For 下拉列表框中的 Win32 Debug，选择 Category
下拉列表框中的 Code Generation，最后从 Use run-time library 下拉列表框中选择 Debug
Multithreaded DLL。配置结果如图 6-17。
16
该文档版权归上海微视泰科工作室所有，转载请注明出处!
网址：http://www.microvt.com
Email: hightechyoung@yahoo.com
作者：HighTech Young
图 6-16 配置项目的 Release 版本
图 6-17 配置项目的 Debug 版本
17
该文档版权归上海微视泰科工作室所有，转载请注明出处!
网址：http://www.microvt.com
Email: hightechyoung@yahoo.com
作者：HighTech Young
4. 在 LabVIEW 项目中调用.dll 中的函数。
创建如图 6-18 所示的 VI，其中 Array 为 Representation»Single Precision 类型的数组，Sum 为
Representation»Single Precision 类 型 的 Indicator, error 为 Representation»Long 类 型 的
Indicator。运行后可以看到对数组求和的结果。
图 6-18 调用 DLL 中函数的 VI
6.3.3. 调用 Win32 API
在 LabVIEW 可以通过 CFN 调用 Win32 API 或者是硬件驱动供应商提供的驱动程序。通过调用这些函
数用户能利用与操作系统进行交互或者利用第三方供应商提供的函数来扩展自己项目的功能。以下章节以调
用 Win32 API 中 MessageBox 函数来实现一个同时带 Abort, Retry, Ignore 按钮和一个警告图标的消息对
话框为例，叙述在 LabVIEW 中利用 CFN 调用 Win32 API 的方法。
要在 LabVIEW 项目中调用 Win32 API，首先要从 Microsoft 提供的相关开发文档中找到所要调用 API
函数的原型和其所在.dll 文件的名字。要查找这些信息，可以参考 Microsoft Software Development Kit
(SDK)或 MSDN 的相关文档。从文档中找到 MessageBox 函数的原型和相关的一些信息如下。
int MessageBox(HWND hWnd,
LPCTSTR lpText,
LPCTSTR lpCaption,
UINT uType);
// 父窗口的句柄
// 消息窗中显示的文本
// 消息窗的标题
// 消息窗的类型
----Requirements:----
Windows: Requires Windows 98 or later.
Windows CE: Requires version 1.0 or later.
Header: Declared in winuser.h.
Import Library: Use user32.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows.
找到这些信息后，就可以进行调用API函数的的第二步：将参数类型映射为LabVIEW支持的数据类型。
Win32 API函数用了多种非标准C的数据类型，这给在LabVIEW中调用API带来了一点麻烦。但是幸运的是，
API函数所用的这些非标准数据类型只仅仅是标准C数据类型的别名。例如上面例子中MessageBox函数使用
的参数类型与标准C的参数类型有以下映射关系：
HWND
LPCTSTR = const char *
int * *
=
18
相关推荐
2023年江西萍乡中考道德与法治真题及答案.doc
2012年重庆南川中考生物真题及答案.doc
2013年江西师范大学地理学综合及文艺理论基础考研真题.doc
2020年四川甘孜小升初语文真题及答案I卷.doc
2020年注册岩土工程师专业基础考试真题及答案.doc
2023-2024学年福建省厦门市九年级上学期数学月考试题及答案.doc
2021-2022学年辽宁省沈阳市大东区九年级上学期语文期末试题及答案.doc
2022-2023学年北京东城区初三第一学期物理期末试卷及答案.doc
2018上半年江西教师资格初中地理学科知识与教学能力真题及答案.doc
2012年河北国家公务员申论考试真题及答案-省级.doc
2020-2021学年江苏省扬州市江都区邵樊片九年级上学期数学第一次质量检测试题及答案.doc
2022下半年黑龙江教师资格证中学综合素质真题及答案.doc
