|
#include <windows.h>
#include <types.h>
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("SPL: DLL_PROCESS_ATTACH.\r\n"))); /* 提示动态库加载 */
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("SPL: DLL_PROCESS_DETACH.\r\n"))); /* 提示动态库卸载 */
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("::: SPL_Init.\r\n"))); /* 提示驱动加载 */
g_Tmp = 0; /* 初始化全局变量的值 */
g_OpenCount = 0;
return 1; /* 返回一个不为零的数表示成功 */
}
/************************************************************************************
函数名称: SPL_Deinit
描 述: 驱动程序卸载函数
输入参数: DWORD dwContext: 驱动程序句柄
输出参数: 无
返 回: FALSE: 失败 TRUE: 成功
**************************************************************************************/
BOOL SPL_Deinit(DWORD dwContext)
{
RETAILMSG(1, (TEXT("::: SPL_Deinit.\r\n"))); /* 提示驱动卸载 */
g_Tmp = 0; /* 恢复全局变量的值 */
g_OpenCount = 0;
return TRUE;
}
/**************************************************************************************
函数名称: SPL_Open
描 述: 打开驱动程序
输入参数: DWORD hDeviceContext: 设备驱动程序引用实例句柄
DWORD AccessCode : 访问请求代码,是读和写的组合
DWORD ShareMode : 共享模式
输出参数:
返 回: 驱动程序引用事例句柄
**************************************************************************************/
DWORD SPL_Open(DWORD hDeviceContext, DWORD AccessCode, DWORD ShareMode)
{
RETAILMSG(1, (TEXT("::: SPL_Open.\r\n"))); /* 提示驱动打开 */
// 不允许多个应用程序打开本驱动
if (g_OpenCount != 0)
{
RETAILMSG(1, (TEXT("SPL Open failed.\r\n")));/* 提示驱动打开失败 */
return 0;
}
g_OpenCount++; /* 驱动打开计数器加1 */
return g_OpenCount; /* 必须返回一个不为空的句柄 */
}
/**************************************************************************************
函数名称: SPL_Close
描 述: 驱动程序关闭函数
输入参数: DWORD hOpenContext：驱动程序引用事例句柄
输出参数: 无
返 回: FALSE: 失败 TRUE: 成功
**************************************************************************************/
BOOL SPL_Close(DWORD hOpenContext)
{
RETAILMSG(1, (TEXT("::: SPL_Close.\r\n"))); /* 提示驱动关闭 */
if (g_OpenCount != 0)
g_OpenCount--; /* 驱动打开计数减1 */
return TRUE;
}
/**************************************************************************************
函数名称: SPL_IOControl
描 述: 驱动程序 I/O 请求
输入参数:
输出参数:
返 回: TRUE: 成功 FALSE: 失败
**************************************************************************************/
BOOL SPL_IOControl(DWORD hOpenContext,
DWORD dwCode,
PBYTE pBufIn,
DWORD dwLenIn,
PBYTE pBufOut,
DWORD dwLenOut,
PDWORD pdwActualOut)
{
RETAILMSG(1, (TEXT("::: SPL_IOControl.\r\n"))); /* 提示I/O请求函数执行 */
return TRUE;
}
/**************************************************************************************
函数名称: SPL_Read
描 述: 从本驱动读取数据
输入参数: DWORD hOpenContext: 驱动程序引用事例句柄
DWORD Count : 要读的字节数
输出参数: LPVOID pBuffer : 接收缓冲区
返 回: 实际读到的字节数
**************************************************************************************/
DWORD SPL_Read(DWORD hOpenContext, LPVOID pBuffer, DWORD Count)
{
uchar *pReadBuffer;
RETAILMSG(1, (TEXT("::: SPL_Read.\r\n"))); /* 提示执行读函数 */
if ((pBuffer == NULL) || (Count <= 0))
{ /* 读函数入口参数错误 */
RETAILMSG(1, (TEXT("::: SPL_Read() parameter is error.\r\n")));
return 0;
}
// 映射地址空间
/*驱动程序和应用程序之间传递数据时何时调用MapPtrToProcess？
因为设备管理器负责加载驱动程序DLL，这意味着当应用程序调用驱动程序接口函数的时候，WINCE内核会将调用驱动程序接口函数的线程转移到设备管理器的进程空间然后执行具体的驱动程序代码，应用程序和设备管理器处于两个进程空间，这就造成设备管理器无法访问应用程序传递的指针（虚拟地址），所以当我们在应用程序中传递指针给流驱动程序接口函数时，WINCE内核从中作了一个地址映射，例如ReadFile、WriteFile、DeviceIoControl函数的参数凡是指针都经过了映射才传递给驱动程序，所以很多驱动程序开发者并不了解其中的奥秘就可以编程了。但是如果参数是一个指向一个结构体的指针，而结构体里包括一个或多个指针，那么WINCE内核并不负责映射，所以就需要开发者在驱动程序接口函数中调用API函数MapPtrToProcess来映射地址。例如：pPointer_retval = MapPtrToProcess(pPointer, GetCallerProcess()); */
pReadBuffer = MapPtrToProcess(pBuffer, GetCallerProcess());
*pReadBuffer = g_Tmp; /* 返回数据 */
return 1; /* 返回读取的字节数 */
}
/**************************************************************************************
函数名称: SPL_Write
描 述: 向本驱动写入数据
输入参数: DWORD hOpenContext: 驱动程序引用事例句柄
LPVOID pBuffer : 发送缓冲区
DWORD Count : 要写入的字节数
输出参数: 无
返 回: 实际写入的字节数
**************************************************************************************/
DWORD SPL_Write(DWORD hOpenContext, LPCVOID pBuffer, DWORD Count)
{
uchar *pWriteBuffer;
RETAILMSG(1, (TEXT("::: SPL_Write.\r\n"))); /* 提示执行写函数 */
if ((pBuffer == NULL) || (Count <= 0))
{ /* 写函数入口参数错误 */
RETAILMSG(1, (TEXT("::: SPL_Write() parameter is error.\r\n")));
return 0;
}
// 获取应用程序地址空间数据指针
pWriteBuffer = MapPtrToProcess((LPVOID)pBuffer, GetCallerProcess());
g_Tmp = *pWriteBuffer; /* 保存数据 */
return 1;
}
/**************************************************************************************
函数名称: SPL_Seek
描 述: 对设备的数据指针进行操作,本驱动不支持该函数
输入参数:
输出参数:
返 回:
*************************************************************************************/
DWORD SPL_Seek(DWORD hOpenContext, long Amount, DWORD Type)
{
RETAILMSG(1, (TEXT("::: SPL_Seek.\r\n"))); /* 提示执行本函数 */
return 0;
}
/**************************************************************************************
函数名称: SPL_PowerUp
描 述: 电源上电驱动处理函数
输入参数:
输出参数:
返 回: 无
*************************************************************************************/
void SPL_PowerUp(void)
{
RETAILMSG(1, (TEXT("::: SPL_PowerUp.\r\n"))); /* 提示执行本函数 */
}
/**************************************************************************************
函数名称: SPL_PowerDown
描 述: 电源下电驱动处理函数
输入参数:
输出参数:
返 回: 无
**************************************************************************************/
void SPL_PowerDown(void)
{
RETAILMSG(1, (TEXT("::: SPL_PowerDown.\r\n"))); /* 提示执行本函数 */
}
|
