Windows CE Notification API的使用方法

１引言
以Windows CE 为操作系统的掌上电脑(如ＰｏｃｋｅｔＰＣ或ＨＰＣ)，除具备ＰＣ的功能外，还具备很强的自身控制能力。Windows CE ＡＰＩ超越微软其他操作系统的ＡＰＩ的一个方面是他提供了一个强有力的通知接口(ＮｏｔｉｆｉｃａｔｉｏｎＡＰＩ)，该接口允许应用程式自己安排自己在某个确定的时间运行，或在某个系统事件发生时运行，这使得我们能够应用他来设计研发各种高级控制程式，比如按时间或预订的事件来自动开启／关闭电脑，或按时间或预订的事件来自动开启／关闭一个或多个应用程式，乃至控制一个或多个应用程式的运行流程。
２通知ＡＰＩ的解析
所谓通知是操作系统对发生的某个事件所发出的响应信号。Windows CE对定时器事件发出的响应信号即“定时器事件通知”，而对系统事件发出的响应信号即“系统事件通知”。定时器事件表明已到达指定时间，系统事件表明发生了系统级事件,如添加或删除了某设备，系统时间更改了，和其他设备发生同步，检测到ＲＳ２３２口连接等。假如我们要在给定的时间直接运行某个应用程式（不用用户干涉），就能够简单地使用“定时器事件通知”，而当我们需要监控一些系统事件的发生时，就要使用″系统事件通知″。特别需要强调的是：除非不安装电池或处于死机状态，否则掌上电脑的电源始终不关闭；当用户按下关闭电源按钮或不使用时，机器也只是处于休眠状态而并没有真正切断电源（在休眠状态下，他仅提供能保持其时钟、应用程式及ＲＡＭ中存储的数据所需的最少能量）。因此，对于注册使用“定时器事件通知”或″系统事件通知″的程式，即使系统是关闭的，当定时器事件到达时或发生系统事件时，要运行的应用程式也会启动。
上述的“定时器事件通知”的使用虽然方便，但有时不能满足用户的需要。比如对于复杂的控制流程，不但到了指定时间要运行应用程式，而且要根据用户的不同反应进行不同的控制。因此，Windows CE还提供了第三种通知接口： ″用户通知″。″用户通知″也使用定时器事件，但和“定时器事件通知”不同，“用户通知”发生时必须被用户确认，从而到了“用户通知”指定的时间可根据用户的不同反应进行不同的流程控制。比如，当用户仅需在指定的时间作一下提示，则使用“用户通知”的应用程式可设计为以四种方式（闪动ＬＥＤ，振动设备，播放声音和显示提示框）提示用户，而且用户可随时更改提示方式。又比如，当用户需要不但在指定的时间作一下提示，还要在用户做出确认后才使程式继续运行，这就只能使用“用户通知”而不能使用“定时器事件通知”。
当我们把自己研发的程式注册到特定的事件通知后，操作系统将在该事件发生时生成一个通知。系统使用通知和用户和其他程式通信。Windows CE共提供了六个通知接口：
CeSetUserNotification
CeGetUserNotificationPreferences
CeClearUserNotification
CeHandleAppNotifications
CeRunAppAtTime和CeRunAppAtEvent
前四个为″用户通知″所使用，后两个分别为“定时器事件通知”和″系统事件通知″所使用。下面分别介绍这六个ＡＰＩ的使用方法：
（１）函数CeSetUserNotification用于注册用户通知，其原型是：
HANDLE CeSetUserNotification(
HANDLE hNotification,
TCHAR* pwszAppName,
SYSTEMTIME* lpTime,
PCE_USER_NOTIFICATION lpUserNotification
);
其参数含义是：句柄hNotification配置为０表示创建一个新的通知，而要更改已注册的通知则配置hNotification为希望更改的用户通知的句柄（这个句柄是由注册用户通知的程式在调用CeSetUserNotification后的返回值）；pwszAppName是该应用程式的名称，当通知发生时，该应用程式的小图标将在任务栏上显示；lpTime是个指向SYSTEMTIME结构指针，该结构指定了通知发生的时间；lpUserNotification也是个结构指针，他指向PCE_USER_NOTIFICATION结构， Windows CE用该结构描述用户怎样被通知，这个结构的定义是：
typedef struct UserNotificationType {
DWORD ActionFlags;
TCHAR* pwszDialogTitle;
TCHAR* pwszDialogText;
TCHAR* pwszSound;
DWORD nMaxSound;
DWORD dwReserved;
} CE_USER_NOTIFICATION, *PCE_USER_NOTIFICATION;
其中变量ActionFlags是一组定义了在到达指定的时间时以何种形式提示用户的标志：PUN_LED(闪动屏幕)，PUN_VIBRATE(振动设备)，PUN_DIALOG(显示对话框),PUN_SOUND(播放声音文档)和PUN_REPEAT(重复声音文档１０到１５秒)，他能够是上述标志的任意组合。从程式调用CeSetUserNotification开始到用户得到通知的这一时间段中，通知一直处于活动状态。如要在他超时之前修改此通知，程式可通过再次调用CeSetUserNotification来实现
（２）调用CeGetUserNotificationPreferences，函数原型为：
BOOL CeGetUserNotificationPreferences(
HWND hWndParent,
PCE_USER_NOTIFICATION lpNotification
);
这个函数可配置用户通知，以便让用户能有修改提示方式的机会，其中hWndParent是提示框父窗口的窗口句柄。
（３）调用CeClearUserNotification能够实现在用户通知到达之前清除他。
（４）调用CeHandleAppNotifications 函数以确认用户通知。用户通知到达后需要确认。对于显示提示框的通知，确认的方式是点击提示框的确定按钮或按下设备外壳上的通知按钮（此时用户通知仅起到提示的作用，不启动应用程式）；对于不显示提示框的通知，系统将在任务栏上显示注册该通知的程式的图标，当用户点击此图标时系统将启动相应的应用程式的一个实例（系统还传递一个命令行参数lpCmdLine以表明为什么应用程式会运行，该参数是串 APP_RUN_TO_HANDLE_NOTIFICATION加空格加通知的句柄）。对于不显示提示框的用户通知，在应用程式中要调用 CeHandleAppNotifications 函数来确认通知，该函数将任何用于应用程式的活动通知都标记为已处理，并删除任务栏上的图标。在实际编码时还要考虑是否有该应用程式的另一个实例在运行，如有，则应向他发送一个自定义消息由该实例处理此通知并终止自身以节省资源。
（５）调用CeRunAppAtTime生成“定时器事件通知”，函数原型为：
BOOL CeRunAppAtTime(
TCHAR* pwszAppName,
SYSTEMTIME* lpTime
);
其参数含义是：lpTime是个结构指针，该结构指定了运行应用程式的时间；pwszAppName是要运行的应用程式的名称。由于只是在给定的时间自动运行某个应用程式，因此比较简单。要修改“定时器事件通知”，只要再次调用CeRunAppAtTime。因为后一次调用CeRunAppAtTime将替换前一次的通知。要清除“定时器事件通知”，只要在调用CeRunAppAtTime时，在参数lpTime中传递一个NULL指针。
（６）调用CeRunAppAtEvent生成″系统事件通知″，函数原型：
BOOL CeRunAppAtEvent(
TCHAR* pwszAppName,
LONG lWhichEvent
);
其参数含义是：pwszAppName是要运行的应用程式的名称；lWhichEvent 是指出要监控哪一个事件，标志常量如下：
NOTIFICATION_EVENT_NONE 清除事件通知
NOTIFICATION_EVENT_SYNC_END 同步完成通知
NOTIFICATION_EVENT_DEVICE_CHANGE 添加或删除设备通知
NOTIFICATION_EVENT_RS232_DETECTED 检测到ＲＳ２３２连接通知
NOTIFICATION_EVENT_TIME_CHANGE 系统时间更改通知
NOTIFICATION_EVENT_RESTORE_END 设备恢复完成通知
要停止响应系统事件通知，应用程式只要再次调用CeRunAppAtEvent，并在lWhichEvent参数中传递其名称和NOTIFICATION_EVENT_NONE。
３通知ＡＰＩ的使用代码实例
#include
CE_USER_NOTIFICATION g_ceun;
(１) 对CE_USER_NOTIFICATION结构初始化的代码片段． memset (&g_ceun, sizeof(g_ceun));
g_ceun．ActionFlags ＝ PUN_DIALOG;
g_ceun．pwszDialogTitle ＝ szDlgTitle;
g_ceun．pwszDialogText ＝ szDlgText;
g_ceun．pwszSound ＝ szSound;
g_ceun．nMaxSound ＝ sizeof(szSound);
(２)注册用户通知的代码片段:
SYSTEMTIME st; GetLocalTime (&st);
GetModuleFileName (hInst, szExeName,sizeof(szExeName));
hNotify = CeSetUserNotification (0, szExeName,&st, &g_ceun);
(３)配置用户通知的代码段:
CeGetUserNotificationPreferences(hWnd, &g_ceun);
(４)使用CeHandleAppNotifications并只运行一个实例(为节省资源)的代码段 :
//判断应用程式的启动是否源于用户通知
If (lstrcmp(szText,APP_RUN_TO_HANDEL_NOTIFICATION==0)
GetModuleFileName (hInst, szText, sizeof(szText));
CeHandleAppNotifications (szText);
hNotify =(HANDLE)_wtol(pPtr); //取通知的句柄
//检查是否已有应用程式的实例在运行
hWnd = FindWindow(NULL, szAppName);
if(hWnd)／／如有，向他发送一个自定义消息,由他处理此用户通知
SendMessage(hWnd, MYMSG_TELLNOTIFY, 0, (LPARM)hNotify);
//终止自身, 代码略去
(５)使用“定时器事件通知”的代码段:
SYSTEMTIME st; GetLocalTime (&st);
GetModuleFileName (hInst, szExeName, sizeof(szExeName));
CeRunAppAtTime (szExeName, &st);
(６)使用“系统事件通知”的代码段:
LONG lEvent;
if (IsDlgButtonChecked(hWnd, IDC_SYNC_END) ==1)
lEvent != NOTIFICATION_EVENT_SYNC_END;
if (IsDlgButtonChecked(hWnd, IDC_SERIAL_DETECT)==1)
lEvent !=NOTIFICATION_EVENT_RS232_DETECTED;
if (IsDlgButtonChecked(hWnd, IDC_DEVICE_CHANGE)== 1)
lEvent != NOTIFICATION_EVENT_DEVICE_CHANGE;
if (IsDlgButtonChecked(hWnd, IDC_TIME_CHANGE)==1)
lEvent != NOTIFACTION_EVENT_TIME_CHANGE;
if (IsDlgButtionChecked(hWnd, IDC_RESTORE_END) ==1)
lEvent != NOTIFICATION_EVENT_RESTORE_END;
GetModuleFileName (hInst, szExeName, sizeof(szExeName);
CeRunAPpAtEvent(szExeName, lEvent);
以上我们介绍了Windows CE Notification API的使用方法，关于Windows CE应用程式研发环境的使用。

Windows CE Notification API的使用方法相关推荐

Windows CE设备驱动开发之电源管理
4.7电源管理电源管理模块管理设备电源,从而全面改进操作系统的电源使用效率:它所有设备的电源使用,同时能与不支持电源管理的应用程序及驱动程序共存. 使用电源管理可以有效的减少目标设备的电源消耗,同时 ...
《Windows CE嵌入式开发入门——基于Xscale架构》第9章 Windows CE BSP及驱动程序结构分析
9.1 Windows CE驱动程序结构概述 Windows CE的驱动程序可以从多种角度进行区分. 1．从加载以及接口方式来区分可以分为本机设备驱动(Built-In Driver).可加载驱动 ...
Windows CE的电源管理
Windows CE的基本电源管理功能在所有版本的Windows CE操作系统中,图形.视窗和事件子系统(GWES)在电源管理方面都发挥了关键作用.这是因为早期版本的电源管理功能是由用户的活动所驱动 ...
C# Windows CE使用小技巧实例
C# Windows CE使用的一些感受:使用Windows的开发机上用C#启动一个外部程序的方法有很多,但这些方法用在使用WinCE的目标工控机上都无能为力. C# Windows CE使用1. 现 ...
创建安全 Windows CE 设备（转）
Maricia Alforque Microsoft Corporation 2000 年 10 月更新适用于: Microsoft Windows CE 版本 3.0 摘要:本文高度概括 ...
[转] Windows CE 6.0 启动过程分析
看到这么好的文章,小郭觉得不转载就是天理不容,转了!!!! ********************************************************************** ...
转载：Windows CE内存管理
内存管理如果你在写Windows CE 程序中遇到的最重要的问题,那一定是内存问题.一个WinCE 系统可能只有4MB 的RAM,这相对于个人电脑来说是十分少的,因为个人电脑的标准配置已经到了128 ...
Windows CE的电源管理之三
本篇将以Windows Mobile为例介绍Windows CE电源管理的实现,大体上,Windows Mobile分为Pocket PC和Smartphone两种版本.这两者之间的主要区别在于触摸屏 ...
Windows CE下流驱动的动态加载
Windows CE下流驱动的动态加载闲话少说,进入正题.查找EVC的帮助,发现函数ActivateDevice()可用来加载驱动程序.而这个函数的使用是相当简单的.我就不多说了,贴上一段帮助最能说 ...

Windows CE Notification API的使用方法

Windows CE Notification API的使用方法相关推荐

最新文章

热门文章