WinCE 流驱动接口编写一步一步来

WinCE.net中,最简单的一个驱动程序莫过于一个内置(Built-in)设备的流接口驱动。对于

一个不支持热拔插的设备,最快捷的方法就是为其实现一个内置的流接口的驱动。

对于这样一类驱动程序,我们只需要按一种特定的规则实现一个动态库,其中实现对所有的硬件

功能的调用,再将这个动态库加入系统中,然后设置相关的注册表项,使得在系统启动时设备管

理器能识别并且加载这个设备即可。

1.  实现动态链接库

此动态链接库与应用程序层所用的库并不很大差别,源文件可以是CC++、甚至汇编,只是它要

实现以下函数。

u       DllEntry(HINSTANCE DllInstance, INT Reason, LPVOID Reserved )

这个函数是动态链接库的入口,每个动态链接库都需要输出这个函数,它只在动态库被加载和卸

载时被调用,也就是设备管理器调用LoadLibrary而引起它被装入内存和调用UnloadLibrary

其从内存释放时被调用,因而它是每个动态链接库最早被调用的函数,一般用它做一些全局变量

的初始化。

参数:

DllInstanceDLL的句柄,与一个EXE文件的句柄功能类似,一般可以通过它在得到DLL中的一

些资源,例如对话框,除此之外一般没什么用处。

Reason:

一般我们只关心两个值:DLL_PROCESS_ATTACHDLL_PROCESS_DETACHReason等于前者是动态

库被加载,等于后者是动态库被释放。

所以,我们可以在Reason等于前者是初始化一些资源,等于后者时将其释放。

u       DWORD XXX_Init( LPCTSTR pContext, LPCVOID lpvBusContext);
它是驱动程序的动态库被成功装载以后第一个被调用的函数。其调用时间仅次与DllEntry,
而且,当一个库用来生成多于一个的驱动程序实例时仅调用一次DllEntry,而xxx_Init
被调用多次。驱动程序应当在这个函数中初始化硬件,如果初始化成功,就分配一个自已
的内存空间(通常用结构体表示),将自已的状态保存起来,并且将此内存块的地址做为一
DWORD值返回给上层。设备管理器就会用在调用XXX_Open时将此句柄传回,我们就能访问
自已的状态。如果初始化失败,则返回0以通知这个驱动程序没有成功加载,先前所分配的
系统资源应该全部释放,此程序的生命即告终至。
当这个函数成功返回,设备管理器对这个程序就不做进一步处理,除非它设置了更多的特
性。至此一个各为XXX的设备就已经加载成功,当用户程序调用CreateFile来打开这个设备
时,设备管理器就会调XXX_Open函数。
参数:
pContext系统传入的注册表键,通过它可以讲到我们在注册表中设置的配置信息。
lpvBusContext一般不用。
实际上,很多程序中将这个函数写成了DWORD XXX_Init( DWORD pContext ),我们只需要
pContext转化成LPCTSTR即可。
u       DWORD XXX_Open(DWORD hDeviceContext,DWORD dwAccess, DWORD dwShareMode);
当用户程序调用CreateFile打开这个设备时,设备管理器就会调用此驱动程序的XXX_Open
函数。
参数:
hDeviceContext XXX_Init 返回给上层的值,也就是我们在XXX_Init中分配的用来记录驱
动程序信息的那个结构体的指针,我们可以在这个函数中直接将其转化成所定义的结构,
从而获取驱动程序的信息。
dwAccess 上层所要求的访问方式,可以是读或者写,或者是0,即不读也不写。
dwShareMode 上层程序所请求的共享模式,可以是共享读、共享写这两个值的逻辑或,或
者是0,即独占式访问。
系统层对设备文件的存取权限及共享方法已经做了处理,所以在驱动程序中对这两个参数
一般可以不用理会。
这个函数一般不用做太多处理,可以直接返回hDeviceContext表示成功对于一个不支持
多个用户的硬件,在设备已经打开后,应该总是返回0以至失败,则CreateFile调用不成
功。
u       DWORD XXX_Close(  DWORD hDeviceContext );
      当用户程序调用CloseHandle关闭这个设备句柄时,这个函数就会被设备管理器调用。
参数:
hDeviceContext XXX_Open返回给上层的那个值。
这个函数应该做与XXX_Open相反的事情,具体包括:释放XXX_Open分配的内存,将驱动程
序被打开的记数减少等。
u       DWORD XXX_Deinit( DWORD hDeviceContext );
这个函数在设备被卸载时被调用,它应该实现与XXX_Init相反的操作,主要为释放前者占
用的所有系统资源。
参数:
hDeviceContext XXX_Init函数返回给上层的那个句柄
u       void XXX  DWORD _PowerUp(hDeviceContext );
u       void XXX_PowerDown(DWORD hDeviceContext );
正如其名称中体现的那样,这两个函数在系统PowerUpPowerDown时被调用,这两个函数
中不能使用任何可能引起线程切换的函数,否则会引起系统死机。所以,在这两个函数
中,实际上几乎是什么做不了,一般在PowerDown时做一个标志,让驱动程序知道自已曾经
Power Down过。在Power Down/On的过程中硬件可能会掉电,所以,尽管Power On以后,
原来的IO操作仍然会从接着执行,但可能会失败。这时,当我们发现一次IO操作失败是因
为程序曾经进入过Power Down状态,就重新初始化一次硬件,再做同样的IO操作。
u       BOOL XXX_IOControl(
                        DWORD hDeviceContext,
                        DWORD dwCode,
                        PBYTE pBufIn,
                        DWORD dwLenIn,
                        PBYTE pBufOut,
                        DWORD dwLenOut,
                        PDWORD pdwActualOut
                   );
几乎可以说一个驱动程序的所有功能都可以在这个函数中实现。对于一类CE自身已经支持
的设备,它们已经被定义了一套IO操作定,我们只需按照各类设备已经定义的内容去实现
所有的IO操作。但当我们实现一个自定义的设备时,我们就可以随心所欲定义我们自已的
IO操作。
参数:
hDeviceContext XXX_Open返回给上层的那个句柄,即我们自已定义的,用来存放程序所有
信息的一个结构。
dwCode IO操作码,如果是CE已经支持的设备类,就用它已经定义好码值,否则就可以自已
定义。
pBufIn 传入的Buffer,每个IO操作码都会定义自已的Buffer结构
dwLenIn pBufIn以字节记的大小 
pBufOutdwLenOut分别为传出的Buffer,及其以字节记的大小
pdwActualOut 驱动程序实际在pBufOut中填入的数据以字节记的大小
其中,前两个参数是必须的,其它的任何一个都有可能是NULL0。所以,当给
pdwActualOut赋值时应该先判断它是否为一个有效的地址。

2.    注册表的设置

系统启动时启动设备管理程序,设备管理程序读取HKEY_LOCAL_MACHINE/Drivers/BuiltIn键的

内容并加载已列出的流接口驱动程序。因此注册表对于驱动的加载有着关键作用。下面我们以设

备名是“STR”来举一个例子:

[HKEY_LOCAL_MACHINE/Drivers/BuiltIn/STR]
  "Prefix"="STR"
  "Dll"="MyDev.Dll"
  "Order"=dword:1

        

其中  "Prefix"="STR" 表示流接口的前缀,我们以后可以通过Creatfile 函数来实现对这

个流接口的操作,实现如下:HANDLE hStr = CreateFile(TEXT("str1:"),

GENERIC_READ | GENERIC_WRITE, 0, NULL, OPEN_EXISTING, 0, 0) 。其中

str1:”中的表示设备好“1”是必需的,不管你的设备当中是不是刚好只有一个,不然的话

出现打开不了这个设备的情况。

"Dll"="MyDev.Dll" 指的是“STR”设备调用的驱动程序 DLL

HKEY_LOCAL_MACHINE/Drivers/BuiltIn/SampleDev 表示该注册表存在于CE系统注

册表的 HKEY_LOCAL_MACHINE/Drivers/BuiltIn/SampleDev 目录下。

3.    创建MakefileSources.def文件

这三个文件主要是来控制编译的,Makefile .def 文件实现比较简单,Sources 文件相

对比较复杂。

Makefile 只需要这样一行!INCLUDE $(_MAKEENVROOT)/makefile.def ,具体的实现

什么任务还不知道。

.def 文件定义需要输出的函数,这些函数能够被其它代码用动态加载的方法调用。

Sources 这个文件很重要,内容也多,最基本的一个文件该有如下内容。

 

TARGETNAME=MyDev(指定要生成的动态库的名称)

TARGETTYPE=DYNLINK(指定要生成的是一个动态库)

TARGETLIBS=$(_COMMONSDKROOT)/lib/$(_CPUINDPATH)/coredll.lib /

              $(_COMMONOAKROOT)/lib/$(_CPUINDPATH)/ceddk.lib

(下面两项指定需要与哪些动态库链接,一般要第一项就足够了)

DLLENTRY=DllEntry(指定动态库的入口函数)

SOURCES= (请在这写上你所有源文件的名字,它们将会被编译)

阅读更多
个人分类: wince
想对作者说点什么? 我来说一句

没有更多推荐了,返回首页

关闭
关闭
关闭