WinCE OAL中的OEMIoControl函数详解

在这里只是对OEMIoControl中比较常用的case说一说。看看PB的文档就知道OEMIoControl函数可以包含很多case而且被分了类。下面就我个人接触到的和比较常用的做个说明:

1. IOCTL_HAL_INIT_RTC

对应OALIoctlHalInitRTC函数,该case用于重新初始化RTC。在系统冷启动的时候,内核会调用它来设置时钟。

dwIoControlCode:IOCTL_HAL_INIT_RTC

lpInBuf:要设置的时钟结构体

实际上在该case中一般都是注册RTC的ALARM中断,然后调用OEMSetRealTime函数来进行设置。关于OAL中的RTC的说明,可以参考我在2008年1月写的“WinCE中RTC驱动开发介绍”。

2. IOCTL_HAL_POSTINIT:

对应OALIoctlHalPostInit函数,该case会被内核调用,不传入任何数据,也不返回任何数据。在系统进程启动之前,它提供了最后一次机会让我们在OAL中做一些动作。

3. IOCTL_HAL_ILTIMING:

对应OALIoctlHalILTiming函数,该case实现了对ILTiming的支持,当Iltiming.exe运行时,该case会被调用。

dwIoControlCode:IOCTL_HAL_ILTIMING

lpInBuf:传入ILTiming结构

4. IOCTL_HAL_REBOOT:

对应OALIoctlHalReboot函数,该case用于热启动系统。

5. IOCTL_HAL_ENABLE_WAKE

对应OALIoctlHalEnableWake函数,该case用于添加可唤醒系统的中断源。

dwIoControlCode:IOCTL_HAL_ENABLE_WAKE

lpInBuf:可唤醒系统的系统中断号

6. IOCTL_HAL_DISABLE_WAKE:

对应OALIoctlHalDisableWake函数,该case用于删除可唤醒系统的中断源。

dwIoControlCode:IOCTL_HAL_DISABLE_WAKE

lpInBuf:被删除的系统中断号

7. IOCTL_HAL_GET_HIVE_CLEAN_FLAG:

对应OALIoctlHalGetHiveCleanFlag函数,该case会被Filesys模块调用,用于确定是否清除系统Hive和用户Hive。

dwIoControlCode:IOCTL_HAL_GET_HIVE_CLEAN_FLAG

lpInBuf:HIVECLEANFLAG_SYSTEM表示查询系统Hive;HIVECLEANFLAG_USERS表示查询用户Hive

lpOutBuf:返回TRUE表示清除,返回FALSE表示不清除

8. IOCTL_HAL_GET_HIVE_RAM_REGION:

对应OALIoctlHalGetHiveRamRegion函数,该case会被Filesys模块调用,返回一块内存区域用来存放Hive,此时系统Hive和用户Hive是存放在一起的,所以所有的用户都使用同一个用户Hive。

dwIoControlCode:IOCTL_HAL_GET_HIVE_RAM_REGION

lpOutBuf:返回一个存放Hive的RAM结构信息

9. IOCTL_HAL_QUERY_FORMAT_PARTITION:

对应OALIoctlHalQueryFormatPartition函数,该case会被Filesys模块调用,返回是否需要格式化某个分区。对于一块存储介质来说,如果在该介质驱动的注册表配置中设置了CheckForFormat项,Filesys模块才会调用该case,例如:

[HKEY_LOCAL_MACHINE\System\StorageManager\Profiles\MyProfile\FATFS]

    "CheckForFormat"=dword:1

dwIoControlCode:IOCTL_HAL_QUERY_FORMAT_PARTITION

lpInBuf:传入存储介质的信息

lpOutBuf:返回TRUE表示该分区需要格式化,返回FALSE表示不需要格式化

10. IOCTL_HAL_REQUEST_IRQ:

对应OALIoctlHalRequestIrq函数,该case用于为一个总线设备申请硬件中断号。

dwIoControlCode:IOCTL_HAL_REQUEST_IRQ

lpInBuf:传入总线设备的位置信息

lpOutBuf:返回硬件中断号

11. IOCTL_HAL_REQUEST_SYSINTR:

对应OALIoctlHalRequestSysintr函数,该case用于完成物理IRQ到系统中断之间的映射。

dwIoControlCode:IOCTL_HAL_REQUEST_SYSINTR

lpInBuf:物理IRQ

lpOutBuf:系统中断SYSINTR

12. IOCTL_HAL_RELEASE_SYSINTR:

对应OALIoctlHalReleaseSysintr,该case用于释放以前申请的系统中断SYSINTR。

dwIoControlCode:IOCTL_HAL_RELEASE_SYSINTR

lpInBuf:要被释放的系统中断SYSINTR

13. IOCTL_PROCESSOR_INFORMATION:

对应OALIoctlHalProcessorInformation函数,该case用于应用程序获得处理器的相关信息。

dwIoControlCode:IOCTL_PROCESSOR_INFORMATION

lpOutBuf:返回处理器的相关信息

14. IOCTL_HAL_GET_DEVICE_INFO:

对应OALIoctlHalGetDeviceInfo函数,该case用于获得系统的相关参数信息。

dwIoControlCode:IOCTL_HAL_GET_DEVICE_INFO

lpInBuf:系统信息码SPI_xxx

lpOutBuf:根据SPI_xxx码,返回相应的系统信息

15. IOCTL_HAL_QUERY_DISPLAYSETTINGS:

对应OALIoctlHalQueryDisplaysettings函数,该case会被GDI调用来查询显示分辨率和显示深度等信息。

dwIoControlCode:IOCTL_HAL_QUERY_DISPLAYSETTINGS

lpOutBuf:返回显示宽度,高度和深度

 

【编辑推荐】

  1. 在WinCE中获取设备ID
  2. WinCE编译过程的四个阶段
  3. WinCE中触摸屏驱动开发详解
  4. Windows Mobile和WinCE的区别
  5. 基于WinCE的液位遥测系统软件设计
THE END