Wince5.0驱动程序基础开发
creator
第一课 实现最简单的SimpleDriver驱动
现在开始一步一步的学习wince5.0的驱动开发,我们先从最简单的说起。今天做最简单的驱动。我们称之为SimpleDriver。它是一个简单的buildin的流驱动。
步骤如下:
1.在platform下driver目录下建立一个Simple目录,首先建立SimpleDriver.c文件。驱动要实现以下几个接口:
SimpleDriver.c如下:
#include
#include
static BYTE g_Tmp = 0; /* 暂存数据变量 */
static DWORD g_OpenCount = 0; /* 驱动打开计数器 */
/**************************************************************************************
函数名称: DllMain 有些采用其他名字如DllEntry ,这样在sources中要指明DLLENTRY=DllEntry(指定动态库的入口函数)
描 述: 驱动程序动态库入口
输入参数:
输出参数:
返 回:
**************************************************************************************/
BOOL WINAPI DllMain(HANDLE hInstDll, DWORD dwReason, LPVOID lpvReserved) {
switch ( dwReason )
{
/*DLL_PROCESS_ATTACH
大家都知道,一个程序要调用Dll里的函数,首先要先把DLL文件映射到进程的地址空间。要把一个DLL文件映射到进程的地址空间,有两种方法:静态链接和动态链接的LoadLibrary或者LoadLibraryEx。
当一个DLL文件被映射到进程的地址空间时,系统调用该DLL的DllMain函数,传递的fdwReason参数为DLL_PROCESS_ATTACH。这种调用只会发生在第一次映射时。如果同一个进程后来为已经映射进来的DLL再次调用LoadLibrary或者LoadLibraryEx,操作系统只会增加DLL的使用次数,它不会再用DLL_PROCESS_ATTACH调用DLL的DllMain函数。不同进程用LoadLibrary同一个DLL时,每个进程的第一次映射都会用DLL_PROCESS_ATTACH调用DLL的DllMain函数。*/
case DLL_PROCESS_ATTACH:
RETAILMSG(1, (TEXT(\ /* 提示动态库加载 */
DisableThreadLibraryCalls((HMODULE) hInstDll);
break;
/*当DLL被从进程的地址空间解除映射时,系统调用了它的DllMain,传递的fdwReason值是DLL_PROCESS_DETACH。当DLL处理该值时,它应该执行进程相关的清理工作。
那么什么时候DLL被从进程的地址空间解除映射呢?两种情况:
◆FreeLibrary解除DLL映射(有几个LoadLibrary,就要有几个FreeLibrary)
◆进程结束而解除DLL映射,在进程结束前还没有解除DLL的映射,进程结束后会解除DLL映射。(如果进程的终结是因为调用了TerminateProcess,系统就不会用
DLL_PROCESS_DETACH来调用DLL的DllMain函数。这就意味着DLL在进程结束前没有机会执行任何清理工作。)
注意:当用DLL_PROCESS_ATTACH调用DLL的DllMain函数时,如果返回FALSE,说明没有初始化成功,系统仍会用DLL_PROCESS_DETACH调用DLL的DllMain函数。因此,必须确保没有清理那些没有成功初始化的东西。*/
case DLL_PROCESS_DETACH:
RETAILMSG(1, (TEXT(\ /* 提示动态库卸载 */
break;
/*DLL_THREAD_ATTACH
当进程创建一线程时,系统查看当前映射到进程地址空间中的所有DLL文件映像,并用值DLL_THREAD_ATTACH调用DLL的DllMain函数。
新创建的线程负责执行这次的DLL的DllMain函数,只有当所有的DLL都处理完这一通知后,系统才允许进程开始执行它的线程函数。
注意跟DLL_PROCESS_ATTACH的区别,我们在前面说过,第n(n>=2)次以后地把DLL映像文件映射到进程的地址空间时,是不再用DLL_PROCESS_ATTACH调用DllMain的。而DLL_THREAD_ATTACH不同,进程中的每次建立线程,都会用值DLL_THREAD_ATTACH调用DllMain函数,哪怕是线程中建立线程也一样。
DLL_THREAD_DETACH
如果线程调用了ExitThread来结束线程(线程函数返回时,系统也会自动调用ExitThread),系统查看当前映射到进程空间中的所有DLL文件映像,并用DLL_THREAD_DETACH来调用DllMain函数,通知所有的DLL去执行线程级的清理工作。
注意:如果线程的结束是因为系统中的一个线程调用了TerminateThread,系统就不会用值DLL_THREAD_DETACH来调用所有DLL的DllMain函数*/
}
return (TRUE); }
/**************************************************************************************
函数名称: SPL_Init
描 述: 驱动程序初始化函数
输入参数: DWORD dwContext: 设备管理器传递给本驱动的参数, 通常为流接口驱动在注册表内的位置
输出参数: 无
返 回: 驱动程序句柄
**************************************************************************************/
DWORD SPL_Init(DWORD dwContext) {
RETAILMSG(1, (TEXT(\ /* 提示驱动加载 */
g_Tmp = 0; /* 初始化全局变量的值 */
g_OpenCount = 0;
return 1; /* 返回一个不为零的数表示成功 */ }
/******************************************************************************

