WinCE OAL中的电源管理函数

关于OEMIoControl函数，我在2008年1月份写过一篇blog叫“WinCE BSP中OAL层中的OEMIoControl介绍”，已经比较详细的介绍了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：返回显示宽度，高度和深度