在VC中创建并调用DLL
转自:http://express.ruanko.com/ruanko-express_45/technologyexchange6.html
一、DLL简介
1.什么是DLL?
动态链接库英文为DLL,是Dynamic Link Library 的缩写形式,DLL是一个包含可由多个程序同时使用的代码和数据的库,DLL不是可执行文件。动态链接提供了一种方法,使进程可以调用不属于其可执行代码的函数。函数的可执行代码位于一个 DLL 中,该 DLL 包含一个或多个已被编译、链接并与使用它们的进程分开存储的函数。DLL 还有助于共享数据和资源。多个应用程序可同时访问内存中单个DLL 副本的内容。DLL 是一个包含可由多个程序同时使用的代码和数据的库。
动态链接库可以更为容易地将更新应用于各个模块,而不会影响该程序的其他部分。例如,您有一个大型网络游戏,如果把整个数百MB甚至数GB的游戏的代码都 放在一个应用程序里,日后的修改工作将会十分费时,而如果把不同功能的代码分别放在数个动态链接库(DLL)中,您无需重新生成或安装整个程序就可以应用更新。
2.DLL的优点
1、扩展了应用程序的特性;
2、可以用许多种编程语言来编写;
3、简化了软件项目的管理;
4、有助于节省内存;
5、有助于资源共享;
6、有助于应用程序的本地化;
7、有助于解决平台差异;
8、可以用于一些特殊的目的。windows使得某些特性只能为DLL所用。
二、DLL创建
添加一个解决方案,然后在解决方案下面添加一个新项目,选择项目类型为“Win32项目”,并输入项目名称,并点击确定,如图1所示:
图1
在“Win32 应用程序向导”中,选择应用程序类型为“DLL”,并在附加选项中,勾选“导出符号”,并点击“完成”按钮,如图2所示:
图2
点击完成后,系统会创建相应的项目文件,如图3所示:
图3
MyDLL.h中的相应代码如下所示:
// 下列ifdef 块是创建使从DLL 导出更简单的 // 宏的标准方法。此DLL 中的所有文件都是用命令行上定义的MYDLL_EXPORTS // 符号编译的。在使用此DLL 的 // 任何其他项目上不应定义此符号。这样,源文件中包含此文件的任何其他项目都会将 // MYDLL_API 函数视为是从DLL 导入的,而此DLL 则将用此宏定义的 // 符号视为是被导出的。 #ifdef MYDLL_EXPORTS #define MYDLL_API __declspec(dllexport) #else #define MYDLL_API __declspec(dllimport) #endif // 此类是从MyDLL.dll 导出的 class MYDLL_API CMyDLL { public: CMyDLL(void); // TODO: 在此添加您的方法。 }; extern MYDLL_API int nMyDLL; MYDLL_API int fnMyDLL(void); MyDLL.cpp文件内容 // MyDLL.cpp : 定义DLL 应用程序的入口点。 // #include "stdafx.h" #include "MyDLL.h" #ifdef _MANAGED #pragma managed(push, off) #endif //DLL被调用时的入口 BOOL APIENTRY DllMain( HMODULE hModule, DWORD ul_reason_for_call, LPVOID lpReserved ) { //判断被调用的方式,根据实际被调用的方式,可以在下列判断中来做相应的操作,比如初始化工作 switch (ul_reason_for_call) { case DLL_PROCESS_ATTACH: case DLL_THREAD_ATTACH: case DLL_THREAD_DETACH: case DLL_PROCESS_DETACH: break; } return TRUE; } #ifdef _MANAGED #pragma managed(pop) #endif // 这是导出变量的一个示例 MYDLL_API int nMyDLL=0; // 这是导出函数的一个示例。 MYDLL_API int fnMyDLL(void) { return 42; } // 这是已导出类的构造函数。 // 有关类定义的信息,请参阅MyDLL.h CMyDLL::CMyDLL() { return; } |
编译并生成DLL项目,如下图所示:
图4
在使用的过程中,要用到生成的dll、lib文件。但两者有什么区别和联系呢?
Lib(引入库文件)是编译时需要的,dll是运行时需要的。引入库文件包含被DLL导出的函数的名称和位置,DLL包含实际的函数和数据,应用程序使用LIB文件链接到所需要使用的DLL文件,库中的函数和数据并 不复制到可执行文件中,因此在应用程序的可执行文件中,存放的不是被调用的函数代码,而是DLL中所要调用的函数的内存地址,这样当一个或多个应用程序运 行是再把程序代码和被调用的函数代码链接起来,从而节省了内存资源。
开发和使用dll需注意三种文件:
1)dll头文件
它是指dll中说明输出的类或符号原型或数据结构的.h文件。当其它应用程序调用dll时,需要将该文件包含入应用程序的源文件中。
2)dll的引入库文件(.lib)
它是dll在编译、链接成功后生成的文件。主要作用是当其它应用程序调用dll时,需要将该文件引入应用程序。否则,dll无法引入。
3)dll文件(.dll)
它是应用程序调用dll运行时,真正的可执行文件。dll应用在编译、链接成功后,.dll文件即存在。开发成功后的应用程序在发布时,只需要有.exe文件和.dll文件,不必有.lib文件和dll头文件。
从使用的角度上来看,如何静态调用,则要用到lib文件,而动态调用则不用,只需要DLL文件就够了。
三、DLL调用
DLL的调用分为动态和静态两种:动态调用和静态调用。动态调用方式的特点是完全由编程者用 API 函数加载和卸载 DLL,程序员可以决定 DLL 文件何时加载或不加载,显式链接在运行时决定加载哪个 DLL 文件。
动态调用,即显式调用方式,是由编程者用API函数加载和卸载DLL来达到调用DLL的目的,比较复杂,但能更加有效地使用内存,是编制大型应用程序时的重要方式。在Windows系统中,与动态库调用有关的函数包括:
①LoadLibrary(或MFC 的AfxLoadLibrary),装载动态库。
②GetProcAddress,获取要引入的函数,将符号名或标识号转换为DLL内部地址。
③FreeLibrary(或MFC的AfxFreeLibrary),释放动态链接库。
静态调用,也称为隐式调用,由编译系统完成对DLL的加载和应用程序结束时DLL卸载的编码(Windows系统负责对DLL调用次数的计数),调用方式简单,能够满足通常的要求。通常采用的调用方式是把产生动态连接库时产生的.LIB文件加入到应用程序的工程中,想使用DLL中的函数时,只须在源文件中声明一下。
LIB文件包含了每一个DLL导出函数的符号名和可选择的标识号以及DLL文件名,不含有实际的代码。Lib文件包含的信息进入到生成的应用程序中,被调用的DLL文件会在应用程序加载时同时加载在到内存中。
静态调用方式的特点是由编译系统完成对DLL的加载和应用程序结束时 DLL 的卸载。当调用某DLL的应用程序结束时,若系统中还有其它程序使用该 DLL,则Windows对DLL的应用记录减1,直到所有使用该DLL的程序都结束时才释放它。静态调用方式简单实用,但不如动态调用方式灵活。
1.静态调用
那么接下来就是,创建一个MFC项目来调用刚刚生成的DLL里面封装的函数、类。
首先在同一个解决方案下面创建一个MFC应用程序,如图5 所示:
图5
选择基于对话框的应用程序,然后选择“完成”按钮,如下图所示:
图6
右键点击MFC应用程序的属性,然后在左侧树形列表中,选择“C/C++”,在“附加包含目录”里面,添加“..\MyDLL”(为什么加上这个?因为我们在测试程序中,会调用DLL里面包含可调用函数的定义头文件,而我们不将这个文件拷发到自己的项目下面,而直接将DLL的目录的相对地址,添加到附加包含目录里面。)
图7
另外,静态调用会根据DLL的Lib文件来获取相应的封装函数,因此,我们在“链接器”->“输入”->“附加依赖项”里面,添加MyDLL.lib所在的相对地址。
图8
接着,在T_MyDLLDlg.cpp文件中,添加引用DLL的头文件“MyDLL.h”
// T_MyDLLDlg.cpp : 实现文件 #include "stdafx.h" #include "T_MyDLL.h" #include "T_MyDLLDlg.h" #include "MyDLL.h" //添加头文件 |
在初始化函数中,开始调用DLL里面的封装函数和类,在那里,我们可以打一下断点,然后去看看n的值是否发生了变化,我们定义了一个CMyDLL的对象,是否存在内容。
BOOL CT_MyDLLDlg::OnInitDialog() { CDialog::OnInitDialog(); // .... //调用DLL里面的方法和类 int n = fnMyDLL(); CMyDLL myDll; return TRUE; // 除非将焦点设置到控件,否则返回TRUE } |
经过这里,我们就可以实现了一个简单的DLL的创建以及调用,虽然在DLL里面,封装的是系统自动创建的一些函数和代码,但我们也可以依葫芦画瓢添加自己的函数。
比如:在CMyDLL类里面添加一个带参数的Add函数,实现简单的相加功能,也可以像fnMyDLL一样,添加一个成员函数,来实现其他功能(参见例子:DLLDemo解决方案下面T_MyDLL例子)。
2.动态调用
动态调用要知道DLL的文件路径,并且知道接口函数的类型及参数,并不需要依赖到.h文件、lib文件等内容。
但是,要动态调用DLL里面的函数的话,那么在该函数的前面必须要添加一个extern "C"(声明为C编译、连接方式的外部函数),不然动态调用会找不到这个函数地址的。
如下,在MyDLL.h中添加下列代码:
extern "C" MYDLL_API int Add(int a, int b); |
在MyDLL.cpp中添加下列代码:
MYDLL_API int Add(int a, int b) { return a + b; } |
创建一个MFC对话框应用程序,然后在初始化函数中加入下列代码:
{ CDialog::OnInitDialog(); // ....省略其他代码 //加载MyDLL.dll HINSTANCE hDllInst = AfxLoadLibrary(_T("MyDLL.dll")); //判断是否加载成功 if(hDllInst) { //根据DLL里面的封装函数来定义函数指定 typedef int(*pAdd)(int ,int); pAdd myAdd; //根据函数名来从已加载的DLL中获取函数地址并赋值 myAdd = (pAdd)GetProcAddress(hDllInst, "Add"); //判断是否获取成功 if(myAdd != NULL) { //调用该函数 int a = myAdd(10, 20); CString str; str.Format(_T("%d"), a); TRACE(str); } //释放加载的DLL AfxFreeLibrary(hDllInst); } return TRUE; } |
(参见例子:DLLDemo解决方案下面D_MyDLL例子)
四、DLL深入应用
1.DEF文件
.def是指模块定义文件。它被用于导出一个DLL的函数,和__declspec(dllexport)很相似。模块定义文件的作用即是,告知编译器不要以microsoft编译器的方式处理函数名,而以指定的某方式编译导出函数(比如有函数func,让编译器处理 后函数名仍为func)。这样,就可以避免由于microsoft VC++编译器的独特处理方式而引起的链接错误。
具体的一些说明可参见:http://msdn.microsoft.com/zh-cn/28d6s79h%28VS.90%29.aspx
下面将,介绍在MyDLL项目中添加一个Def文件,并添加相应的内容:
图9
图10
双击MyDLL文件,并在其中添加下列代码:
LIBRARY "MyDLL" EXPORTS fnMyDLL @1 MyADD = Add @2 |
在这里EXPORTS下面的是导出函数的列表,@1代表的是一个导出的顺序编号。而MyADD=Add这句话的意思是,Add函数可允许被外部调用的时候用到MyADD这个名字。目前实验,只针对动态调用这种方式,也就是说在动态调用的时候,通过函数名来获取函数地址的时候,函数名可使用MyADD这个名字,那么在DLLDemo解决方案下面D_MyDLL例子里面,可以这样子用:
myAdd = (pAdd)GetProcAddress(hDllInst, "MyADD"); |
2.共享内存
不同的应用程序都拥有各自的内存区域,那么两个进程间如何共同访问同一个内存区域呢?DLL是实现这种方式之一。在DLL可以开辟一块共享内存,能够被调用DLL的不同进程之间进行数据共享,可以达到各种各样的应用。那么下面将讲解如何在DLL中进行操作共享内存区域。
首先,创建一个动态链接库项目ShareDLL,然后删除掉系统自动创建的函数和变量。然后在ShareDLL.cpp中添加下列代码:
#pragma data_seg(".shared") TCHAR theBuffer[1024] = {0}; #pragma data_seg() |
然后在ShareDLL.h中添加两个函数:
extern "C" SHAREDLL_API int SetBuffer(TCHAR * IntoDLL); extern "C" SHAREDLL_API int GetBuffer(TCHAR * IntoDLL); |
在ShareDLL.cpp中添加操作代码:
SHAREDLL_API int SetBuffer(TCHAR * IntoDLL) { wcscpy(theBuffer, IntoDLL); return 0; } SHAREDLL_API int GetBuffer(TCHAR * FromDLL) { wcscpy(FromDLL, theBuffer); return 0; } |
然后添加一个模块定义文件ShareDLL.def,在其中添加如下代码:
LIBRARY "ShareDLL" SECTIONS .shared READ WRITE SHARED EXPORTS SetBuffer @1 GetBuffer @2 |
注意:.这里的“.share”与CPP文件前面定义的“#pragma data_seg(".shared")”名字是相同的 ,表明在DLL中创建的共享内存名,是这个DLL自己创建的独有的。
创建两个测试的MFC对话框应用程序,界面如下图所示:
图11
两个按钮,分别调用的是DLL中的两个函数,然后分别在测试程序的设置按钮里面,设置不同的内容,然后再进行查看,你会发现,当TestShare1中进行设置的内容,可以在TestShare2中进行获取并显示。