WinCE流式接口驱动架构

WinCE流式接口驱动架构  


1、流式接口驱动程序简介

       驱动程序是对底层硬件的抽象。应用程序开发者不需要真正理解底层驱动的工作原理,他们只需要通过Windows CE提供的API函数,就可以直接与硬件进行交互。

       WinCE的流式接口驱动程序以动态链接库的形式存在,由设备管理器(通常是device.exe或者gwes.exe)统一加载、管理和卸载。与具有单独目的的内部设备驱动程序相比,所有流式接口驱动程序都是用同一接口并调用同一个函数集。

       每个流式接口驱动程序必须实现一组标准的函数,用来完成标准的文件I/O函数和电源管理函数,这些函数提供给WinCE操作系统的内核使用。这些函数通常叫做流式接口驱动程序的DLL接口,如表3-1所示:

表3-1 流式接口驱动程序要实现的DLL接口:

函数名称

描述

XXX_Close

在驱动程序关闭时应用程序通过CloseHandle函数调用这个函数

XXX_Deinit

当设备管理器卸载一个驱动程序时调用这个函数

XXX_Init

当设备管理器初始化一个具体设备时调用这个函数.

XXX_IOControl

上层的软件通过DeviceIoControl函数可以调用这个函数

XXX_Open

在打开一个设备驱动程序时应用程序通过CreateFile函数调用这个函数

XXX_PowerDown

在系统调用前调用这个函数

XXX_PowerUp

在系统从新启动前调用这个函数

XXX_Read

在一个设备驱动程序处于打开状态时由应用程序通过ReadFile函数调用

XXX_Seek

对设备的数据指针进行操作,由应用程序通过SetFilePointer函数调用

XXX_Write

在一个设备驱动程序处于打开状态时由应用程序通过WriteFile函数调用.

       在实际开发中接口名称中的XXX三个字母由设备驱动的设备名前缀代替,例如,如果一个流式接口驱动程序的设备文件名前缀为“STR”,那么它相应要实现的DLL接口为STR_Close,STR_Deinit,STR_Init,STR_Read等。

       下面介绍几个主要的流式接口驱动接口函数:

 

(1)、DWORD XXX_Open ( DWORD hDeviceContext,

                        DWORD AccessCode,

                        DWORD ShareMode )

参数:DWORD hDeviceContext,设备驱动的句柄,由XXX_Init函数创建式返回;

         DWORD AccessCode,传给驱动程序使用的地址,这个地址跟读和写有关;

      DWORD ShareMode,共享模式,

返回值:返回驱动程序引用实例句柄。

描述:这个函数用于打开一个设备驱动程序,当应用程序准备对某个设备进行读或写操作时,系统必须先执行CreateFile()这个函数用于打开这个设备,这个函数执行后才能执行读和写操作;

(2)、BOOL XXX_Close(DWORD hOpenContext)

参数:DWORD hOpenContext,设备驱动的句柄,由XXX_Open创建。

返回值:调用成功返回TRUE,失败返回FALSE

描述:这个函数用于关闭一个驱动程序的引用实例,应用程序通过CloseHandle()函数来调用这个函数,当执行完这个函数后,hOpenContext将不再有效;

(3)、DWORD XXX_Read( DWORD hOpenContext,

                           LPVOID pBuffer,

                           DWORD Count)

参数:DWORD hOpenContext,由CreateFile()函数返回的句柄;

      LPVOID pBuffer,一个缓冲区地址,用于从驱动读数据;

         DWORD Count,需要读缓冲区的长度

返回值:实际读缓冲区的长度

描述:当一个流式接口驱动程序已经打开后,可以使用ReadFile()函数对这个设备进行读操作。ReadFile()中的hFile参数对应设备的引用实例句柄hOpenContext,二参数lpBuffer将传给pBuffer,用于表示要读缓冲区的地址,参数nNumberOfByteToRead将传给Count,表示读取缓冲区的长度。

(4)、DWORD XXX_Write( DWORD hOpenContext,

                           LPVOID pBuffer,

                           DWORD Count)

参数:DWORD hOpenContext,由CreateFile()函数返回的句柄;

      LPVOID pBuffer,一个缓冲区地址,用于从驱动写数据;

         DWORD Count,需要写缓冲区的长度

返回值:实际写缓冲区的长度

描述:当一个流式接口驱动程序已经打开后,可以使用WriteFile()函数对这个设备进行写操作。

(5)、BOOL XXX_IOControl(DWORD hOpenContext,

                           WORD  dwCode,

                           PBYTE pBufIn,

                           DWORD dwLenIn,

                           PBYTE pBufOut,

                           DWORD dwLenOut,

                                             PDWORD pdwActualOut)

参数:DWORD hOpenContext,由CreateFile()函数返回的句柄;

   WORD  dwCode,用于描述这次IOControl操作的语义,由用户自己定义;

   PBYTE pBufIn,缓冲区指针指向需要传送给驱动程序使用的数据;

   DWORD dwLenIn,要传送给驱动程序使用数据的长度;

   PBYTE pBufOu,缓冲区指针指向驱动程序传给应用程序使用的数据;

   DWORD dwLenOut,要传送给应用程序使用数据的长度;

   PDWORD pdwActualOut,返回实际处理数据的长度;

返回值:调用成功返回TRUE,失败返回FALSE

描述:这个函数通常用于向设备发送一个命令,应用程序使用DeviceIOControl函数来通知操作系统调用这个函数,通过参数dwCode来通知驱动程序要执行的操作。这个函数扩展了流式接口驱动程序的功能。

(6)、DWORD XXX_Init(DWORD dwContext)

参数:DWORD dwContext,指向字符串的指针,通常这个参数都为一个流式接口驱动在注册表内的设置。

返回值:如果调用成功返回一个驱动程序的句柄;

描述:当用户使用一个设备的时候,设备管理器调用这个函数来对设备进行初始化。这个函数并不是由应用程序调用的,而是通过设备管理器提供的ActiveDeviceEx()来调用。函数执行成功后返回一个设备的句柄。


阅读更多
想对作者说点什么? 我来说一句

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

关闭
关闭
关闭