VS2005下如何新建一个WINCE设备的DLL工程

VS2005下如何新建一个WINCE设备的DLL工程
——侯晓东

一、 动态链接库简介
1．1 DLL概述
动态链接库（Dynamic Link Library, j简称DLL）是一些编译过的可执行的程序模块，可以在应用程序中或其他DLL中被调用。DLL应用非常广泛，可以实现多个应用程序的代码和资源共享，是WinCE程序设计中的一个非常重要的组成部分。
DLL设计程序的优点：
l 共享代码、资源和数据。DLL作为一种基于Windows的程序模块，不仅可以包含可执行代码，还可以包括数据和各种资源等，扩大了库文件的使用范围；
l 可将系统模块化，方便升级。
l 隐藏实现细节。
l DLL与语言无关。
1．2 DLL的调用
不论使用何种语言对编译好的DLL进行调用时，基本上都有两种调用方式，即静态调用方式和动态调用方式。静态调用方式由编译系统完成对DLL的加载和应用程序结束时DLL卸载的编码（如还有其他程序使用该DLL，则Windows对DLL的应用记录减1，直到所有相关程序都结束对该DLL的使用时才释放它），简单使用，但不灵活，只能满足一般要求。动态调用方式是由编程者用API函数加载和卸载DLL来达到调用DLL的目的，使用上较复杂，但能更加有效地使用内存，是编制大型应用程序时的重要方式。
1．2．1 DLL的静态调用
DLL的静态调用由编译系统完成对DLL的加载和应用程序结束时DLL卸载，在VS2005中静态调用DLL非常简单：首先在VS2005的“工具->选项->项目和解决方案->VC++目录”里设置库文件的路径；然后将需要的lib文件的名称加入到“项目-〉属性-〉配置属性-〉连接器-〉输入-〉附属依赖项”，文件名称之间用空格间隔；最后在使用DLL中的函数文件里引用DLL的头文件（.h）即可。
当开发人员通过静态方式编译并生成应用程序时，应用程序中的调用函数与LIB文件中的导出符号相匹配，这些符号或标示进入到生成的EXE文件中。当应用程序运行过程中需要加载DLL文件时，操作系统将根据这些信息查寻并加载DLL，然后通过符号或标示实现对DLL函数的动态链接。当加载应用程序的EXE文件时，所有被应用程序调用的DLL文件都被加载到内存中，这时可执行程序直接通过函数名调用DLL的输出函数，其调用方法与调用程序内部函数相同。
因此，如果设备上没有应用程序所要加载的DLL库时，用户需自己将DLL库拷贝到应用程序所在目录，或系统根目录。
1．2．2 DLL的动态调用
动态调用方式是由编程者用API函数加载和卸载DLL来达到调用DLL的目的，动态调用是指在应用程序中使用LoadLibrary函数或MFC提供的AfxLoadLibrary函数显式调用自己所需要的动态链接库，动态链接库的文件名就是上面两个函数的参数，然后在使用GetProAddress()函数获取所需要引入的函数。完成上述操作后，应用程序可以调用引入的函数。在应用程序退出之前，应该使用FreeLibrary函数或MFC提供的AfxFreeLibrary函数来释放动态链接库。
二 DLL工程的实现
2．1 动态链接库的创建
2．1．1
1、新建一个基于Smart Device的 MFC Smart Device DLL，将项目名称设为eSOM9261API，如图2-1所示。

图 2-1 新建DLL工程名
2、 单击OK，此时将出现DLL的支持平台对话框，选择所支持的平台，由于我们这里的DLL动态库使用eSOM/9261目标板，所以选择EEIC08SDK（eSOM/9261产品自带的SDK包）平台。如图2-2所示。

图 2-2 平台选择
3、 单击Next，将出现DLL的类型选择（如图2-3所示），选中MFC Extension DLL，按Finish可完成DLL向导工作。此时向导将自动生成DLL基本框架。

图 2-3 DLL类型选择
2．1．2
每个DLL必须有一个入口点，这就如如同使用C语言编写的应用程序必须有一个main函数一样，DllMain是一个默认的入口函数，它负责初始化和结束工作，当一个新的线程访问DLL时，都会调用DllMain函数。
打开利用向导生成的eSOM9261API.cpp文件，即可看到DllMain函数的实现。
extern "C" BOOL APIENTRY
DllMain(HANDLE hInstance, DWORD dwReason, LPVOID lpReserved)
{
// Remove this if you use lpReserved
UNREFERENCED_PARAMETER(lpReserved);

if (dwReason == DLL_PROCESS_ATTACH)
{
TRACE0("eSOM9261API.DLL Initializing!/n");

// Extension DLL one-time initialization
if (!AfxInitExtensionModule(eSOM9261APIDLL, reinterpret_cast<HMODULE>(hInstance)))
return 0;
new CDynLinkLibrary(eSOM9261APIDLL);
}
else if (dwReason == DLL_PROCESS_DETACH)
{
TRACE0("eSOM9261API.DLL Terminating!/n");
// Terminate the library before destructors are called
AfxTermExtensionModule(eSOM9261APIDLL);
}
return 1; // ok
}
2．1．3 输出函数的实现方法
DLL中导出函数的声明有两种方式：一种方法在函数名称声明中加上修饰符__declspec(dllexport)，表示输出，此外，还有一种修饰符 extern "C" __declspec(dllexport)，也表示输出，而且该类DLL不仅可以被C++调用，还可以被C调用。在C++下定义C函数时，需要加上extern "C"关键字。下面为DLL测试程序的输出函数的声明。（在eSOM9261API.h文件中）。
#ifdef ESOM9261API_EXPORTS
#define ESOM9261API_API _declspec(dllexport)
#else
#define ESOM9261API_API _declspec(dllimport)
#endif

extern "C"
{
void ESOM9261API_API SetBuzz(void);
void ESOM9261API_API ClearBuzz(void);
}
对应的原文件（eSOM9261API.c）的实现函数如下：
void SetBuzz(void)
{
return;
}
void ClearBuzz (void)
{
return;
}
导出函数另外一种方式是采用模块定义(.def) 文件声明，.def文件为链接器提供了有关被链接程序的导出、属性及其他方面的信息。（eSOM9261API.def的内容）
; eSOM9261API.def : Declares the module parameters for the DLL.
LIBRARY "eSOM9261API"

EXPORTS
SetBuzz
ClearBuzz
采用模块定义.def导出函数声明，如果要求导出函数能够被C语言掉用，必须在函数的实现前加 extern "C"进行修饰。
extern "C" void SetBuzz (void)
{
return ;
}
2．2 动态链接库的调用
2．2．1 静态调用DLL的步骤
利用VS2005生成一个DLL调用测试应用程序eSOM9261Test.sln，并将上述编译好的eSOM9261API.dll和eSOM9261API.lib文件拷贝到本工程的目录下。然后使用VS2005的Project->Properties属性设置中，选中Linker，在Linker的Input选项的Additional Dependencies中输入eSOM9261API.lib如图2-4所示

图 2-4 应用程序引入动态链接库文件
如果在DLL的函数的导出采用头文件的实现方法，必须将DLL的头文件eSOM9261API.h拷贝到在调用DLL的工程中，并在实现文件中引用eSOM9261API.h文件，代码如下：
#include "eSOM9261API.h"
这样就可以使用DLL的导出函数。
如果采用模块（.def）导出DLL中实现函数，则必须在调用DLL的实现文件声明导入函数，代码如下：
extern "C" void __declspec(dllimport) SetBuzz(void);
extern "C" void __declspec(dllimport) ClearBuzz(void);
2．2．2 动态调用DLL的步骤
动态调用方式是使用LoadLibrary API函数加载DLL，然后在使用GetProAddress()函数获取所需要引入的函数。
具体实现方式：
l 添加eSOM9261Test动态链接库工程的实现函数的定义，代码如下：
typedef void (*pSetBuzz) (void);
typedef void (*pClearBuzz) (void);
利用LoadLibrary API函数动态加载动态链接库，代码的黑体部分；
BOOL CTestDllDlg::OnInitDialog()
{
CDialog::OnInitDialog();
SetIcon(m_hIcon, TRUE); // Set big icon
SetIcon(m_hIcon, FALSE); // Set small icon
hModule=LoadLibrary(_T("eSOM9261API.dll"));
if(hModule==NULL)
MessageBox(_T("Load Dll file failed"),_T("System Information"),MB_OK|MB_ICONERROR);
return TRUE; // return TRUE unless you set the focus to a control
}
l 利用GetProcAddress API函数获取需要引用的函数，代码如下：
void CTestDllDlg::OnBnClickedbtnstop()
{
pSetBuzz SetBuzz =(pLedControl)GetProcAddress (hModule,_T("SetBuzz"));
if(LedControl==NULL)
MessageBox(_T("Load LedControl function failed"),_T("System Information"),MB_OK|MB_ICONERROR);
else
SetBuzz();
}