WinCE通知API的解析及在控制程序中的应用

http://www.sudu.cn/info/html/edu/20070313/232608.html

１ 引言
    以Ｗｉｎｄｏｗｓ ＣＥ 为操作系统的掌上电脑(如ＰｏｃｋｅｔＰＣ或ＨＰＣ)，除具有ＰＣ的功能外，还具有很强的自身控制能力。Ｗｉｎｄｏｗｓ ＣＥ ＡＰＩ超越微软其它操作系统的 ＡＰＩ的一个方面是它提供了一个强有力的通知接口(Ｎｏｔｉｆｉｃａｔｉｏｎ ＡＰＩ)，该接口允许应用程序自己安排自己在某个确定的时间运行，或者在某个系统事件发生时运行，这使得我们可以应用它来设计开发各种高级控制程序，比如按时间或预订的事件来自动开启／关闭计算机，或按时间或预订的事件来自动开启／关闭一个或多个应用程序，乃至控制一个或多个应用程序的运行流程。

２  通知ＡＰＩ的解析
    所谓通知是操作系统对发生的某个事件所发出的响应信号。Ｗｉｎｄｏｗｓ ＣＥ对定时器事件发出的响应信号即“定时器事件通知”，而对系统事件发出的响应信号即“系统事件通知”。定时器事件表明已经到达指定时间，系统事件表明发生了系统级事件,如添加或删除了某设备，系统时间更改了，与其它设备发生同步，检测到ＲＳ２３２口连接等。如果我们要在给定的时间直接运行某个应用程序（不用用户干涉），就可以简单地使用“定时器事件通知”，而当我们需要监控一些系统事件的发生时，就要使用″系统事件通知″。特别需要强调的是：除非不安装电池或处于死机状态，否则掌上电脑的电源始终不关闭；当用户按下关闭电源按钮或不使用时，机器也只是处于休眠状态而并没有真正切断电源（在休眠状态下，它仅提供能保持其时钟、应用程序及ＲＡＭ中存储的数据所需的最少能量）。因此，对于注册使用“定时器事件通知”或″系统事件通知″的程序，即使系统是关闭的，当定时器事件到达时或发生系统事件时，要运行的应用程序也会启动。
    上述的“定时器事件通知”的使用虽然方便，但有时不能满足用户的要求。比如对于复杂的控制流程，不但到了指定时间要运行应用程序，而且要根据用户的不同反应进行不同的控制。因此，Ｗｉｎｄｏｗｓ ＣＥ还提供了第三种通知接口： ″用户通知″。″用户通知″也使用定时器事件，但与“定时器事件通知”不同，“用户通知”发生时必须被用户确认，从而到了“用户通知”指定的时间可根据用户的不同反应进行不同的流程控制。比如，当用户仅需在指定的时间作一下提示，则使用“用户通知”的应用程序可设计为以四种方式（闪动ＬＥＤ，振动设备，播放声音和显示提示框）提示用户，而且用户可随时更改提示方式。又比如，当用户要求不仅在指定的时间作一下提示，还要在用户做出确认后才使程序继续运行，这就只能使用“用户通知”而不能使用“定时器事件通知”。
    当我们把自己开发的程序注册到特定的事件通知后，操作系统将在该事件发生时生成一个通知。系统使用通知与用户和其它程序通信。Ｗｉｎｄｏｗｓ ＣＥ共提供了六个通知接口：ＣｅＳｅｔＵｓｅｒＮｏｔｉｆｉｃａｔｉｏｎ、ＣｅＧｅｔＵｓｅｒ ＮｏｔｉｆｉｃａｔｉｏｎＰｒｅｆｅｒｅｎｃｅｓ、 ＣｅＣｌｅａｒｔＵｓｅｒＮｏｔｉｆｉｃａｔｉｏｎ、 Ｃｅ-ＨａｎｄｌｅＡｐｐＮｏｔｉｆｉｃａｔｉｏｎｓ、ＣｅＲｕｎＡｐｐＡｔＴｉｍｅ和ＣｅＲｕｎ Ａｐｐ ＡｔＥｖｅｎｔ，前四个为″用户通知″所使用，后两个分别为“定时器事件通知”和″系统事件通知″所使用。下面分别介绍这六个ＡＰＩ的使用方法：
    （１）函数ＣｅＳｅｔＵｓｅｒＮｏｔｉｆｉｃａｔｉｏｎ用于注册用户通知，其原型是：
    ＨＡＮＤＬＥ ＣｅＳｅｔＵｓｅｒＮｏｔｉｆｉｃａｔｉｏｎ（ＨＡＮＤＬＥ ｈＮｏｔｉｆｉｃａｔｉｏｎ,ＴＣＨＡＲ* ｐｗｓｚＡｐｐＮａｍｅ,ＳＹＳＴＥＭＴＩＭＥ* ｌｐＴｉｍｅ,ＰＣＥ＿ＵＳＥＲ＿ＮＯＴＩＦＩＣＡＴＩＯＮ ｌｐＵｓｅｒＮｏｔｉｆｉｃａｔｉｏｎ）;其参数含义是：句柄ｈＮｏｔｉｆｉｃａｔｉｏｎ设置为０表示创建一个新的通知，而要更改已注册的通知则设置ｈＮｏｔｉｆｉｃａｔｉｏｎ为希望更改的用户通知的句柄（这个句柄是由注册用户通知的程序在调用ＣｅＳｅｔＵｓｅｒＮｏｔｉｆｉｃａｔｉｏｎ后的返回值）；ｐｗｓｚＡｐｐＮａｍｅ是该应用程序的名称，当通知发生时，该应用程序的小图标将在任务栏上显示；ｌｐＴｉｍｅ是一个指向ＳＹＳＴＥＭＴＩＭＥ结构指针，该结构指定了通知发生的时间；ｌｐＵｓｅｒＮｏｔｉｆｉｃａｔｉｏｎ也是一个结构指针，它指向ＰＣＥ＿ＵＳＥＲ＿ＮＯＴＩＦＩＣＡＴＩＯＮ结构， Ｗｉｎｄｏｗｓ ＣＥ用该结构描述用户如何被通知，这个结构的定义是：
ｔｙｐｅｄｅｆ ｓｔｒｕｃｔ ＵｓｅｒＮｏｔｉｆｉｃａｔｉｏｎＴｙｐｅ
ＤＷＯＲＤ ＡｃｔｉｏｎＦｌａｇｓ;
ＴＣＨＡＲ* ｐｗｓｚＤｉａｌｏｇＴｉｔｌｅ;
ＴＣＨＡＲ* ｐｗｓｚＤｉａｌｏｇＴｅｘｔ;
ＴＣＨＡＲ* ｐｗｓｚＳｏｕｎｄ;
ＤＷＯＲＤ ｎＭａｘＳｏｕｎｄ;
ＤＷＯＲＤ ｄｗＲｅｓｅｒｖｅｄ;
?妖ＣＥ＿ＵＳＥＲ＿ＮＯＴＩＦＩＣＡＴＩＯＮ;
    其中变量ＡｃｔｉｏｎＦｌａｇｓ是一组定义了在到达指定的时间时以何种形式提示用户的标志：ＰＵＮ＿ＬＥＤ(闪动屏幕)，ＰＵＮ＿ＶＩＢＲＡＴＥ(振动设备)，ＰＵＮ＿ＤＩＡＬＯＧ(显示对话框),ＰＵＮ＿ＳＯＵＮＤ(播放声音文件)和ＰＵＮ＿ＲＥＰＥＡＴ(重复声音文件１０到１５秒)，它可以是上述标志的任意组合。从程序调用ＣｅＳｅｔＵｓｅｒＮｏｔｉｆｉｃａｔｉｏｎ开始到用户得到通知的这一时间段中，通知一直处于活动状态。如要在它超时之前修改此通知，程序可通过再次调用ＣｅＳｅｔＵｓｅｒＮｏｔｉｆｉｃａｔｉｏｎ来实现
    （２）调用ＣｅＧｅｔＵｓｅｒＮｏｔｉｆｉｃａｔｉｏｎＰｒｅｆｅｒｅｎｃｅｓ（ＨＷＮＤ ｈＷｎｄＰａｒｅｎｔ,ＰＣＥ＿ＵＳＥＲ＿ＮＯＴＩＦＩＣＡＴＩＯＮ ｌｐＮｏｔｉｆｉｃａｔｉｏｎ））可配置用户通知，以便让用户能有修改提示方式的机会，其中ｈＷｎｄＰａｒｅｎｔ是提示框父窗口的窗口句柄。
    （３）调用ＣｅＣｌｅａｒｔＵｓｅｒＮｏｔｉｆｉｃａｔｉｏｎ（ＨＡＮＤＬＥ ｈＮｏ-ｔｉｆｉｃａｔｉｏｎ）可以实现在用户通知到达之前清除它。
    （４）调用ＣｅＨａｎｄｌｅＡｐｐＮｏｔｉｆｉｃａｔｉｏｎｓ 函数以确认用户通知。用户通知到达后要求确认。对于显示提示框的通知，确认的方式是点击提示框的确定按钮或按下设备外壳上的通知按钮（此时用户通知仅起到提示的作用，不启动应用程序）；对于不显示提示框的通知，系统将在任务栏上显示注册该通知的程序的图标，当用户点击此图标时系统将启动相应的应用程序的一个实例（系统还传递一个命令行参数ｌｐＣｍｄＬｉｎｅ以表明为什么应用程序会运行，该参数是串ＡＰＰ＿ＲＵＮ＿ ＴＯ＿ＨＡＮＤＬＥ＿ＮＯＴＩＦＩＣＡＴＩＯＮ加空格加通知的句柄）。对于不显示提示框的用户通知，在应用程序中要调用ＣｅＨａｎｄｌｅＡｐｐＮｏｔｉｆｉｃａｔｉｏｎｓ 函数来确认通知，该函数将所有用于应用程序的活动通知都标记为已处理，并删除任务栏上的图标。在实际编码时还要考虑是否有该应用程序的另一个实例在运行，如有，则应向它发送一个自定义消息由该实例处理此通知并终止自身以节省资源。
    （５）调用ＢＯＯＬ ＣｅＲｕｎＡｐｐＡｔＴｉｍｅ(ＴＣＨＡＲ* ｐｗｓｚ ＡｐｐＮａｍｅ,ＳＹＳＴＥＭＴＩＭＥ* ｌｐＴｉｍｅ)生成“定时器事件通知”，其参数含义是：ｌｐＴｉｍｅ是一个结构指针，该结构指定了运行应用程序的时间；ｐｗｓｚＡｐｐＮａｍｅ是要运行的应用程序的名称。由于只是在给定的时间自动运行某个应用程序，因此比较简单。要修改“定时器事件通知”，只要再次调用ＣｅＲｕｎＡｐｐＡｔＴｉｍｅ。因为后一次调用ＣｅＲｕｎＡｐｐＡｔＴｉｍｅ将替换前一次的通知。要清除“定时器事件通知”，只要在调用ＣｅＲｕｎＡｐｐＡｔＴｉｍｅ时，在参数ｌｐＴｉｍｅ中传递一个ＮＵＬＬ指针。
    （６）调用ＢＯＯＬ ＣｅＲｕｎＡｐｐＡｔＥｖｅｎｔ(ＴＣＨＡＲ* ｐｗｓｚ-ＡｐｐＮａｍｅ,ＬＯＮＧ ｌＷｈｉｃｈＥｖｅｎｔ) 生成″系统事件通知″，其参数含义是：ｐｗｓｚＡｐｐＮａｍｅ是要运行的应用程序的名称；ｌＷｈｉｃｈＥｖｅｎｔ 是指出要监视哪一个事件，标志常量如下：
ＮＯＴＩＦＩＣＡＴＩＯＮ＿ＥＶＥＮＴ＿ＮＯＮＥ     清除事件通知
ＮＯＴＩＦＩＣＡＴＩＯＮ＿ＥＶＥＮＴ＿ＳＹＮＣ＿ＥＮＤ       同步完成通知
ＮＯＴＩＦＩＣＡＴＩＯＮ＿ＥＶＥＮＴ＿ＤＥＶＩＣＥ＿ＣＨＡＮＧＥ    添加或删除设备通知
ＮＯＴＩＦＩＣＡＴＩＯＮ＿ＥＶＥＮＴ＿ＲＳ２３２＿ＤＥＴＥＣＴＥＤ 检测到ＲＳ２３２连接通知
ＮＯＴＩＦＩＣＡＴＩＯＮ＿ＥＶＥＮＴ＿ＴＩＭＥ＿ＣＨＡＮＧＥ 系统时间更改通知
ＮＯＴＩＦＩＣＡＴＩＯＮ＿ＥＶＥＮＴ＿ＲＥＳＴＯＲＥ＿ＥＮＤ   设备恢复完成通知
    要停止响应系统事件通知，应用程序只要再次调用ＣｅＲｕｎＡｐｐＡｔＥｖｅｎｔ，并在ｌＷｈｉｃｈＥｖｅｎｔ参数中传递其名称和ＮＯＴＩＦＩＣＡＴＩＯＮ＿ＥＶＥＮＴ＿ＮＯＮＥ。

３  通知ＡＰＩ的使用代码实例
＃ｉｎｃｌｕｄｅ ＜ｎｏｔｉｆｙ．ｈ＞               
ＣＥ＿ＵＳＥＲ＿ＮＯＴＩＦＩＣＡＴＩＯＮ ｇ＿ｃｅｕｎ;
(１) 对ＣＥ＿ＵＳＥＲ＿ＮＯＴＩＦＩＣＡＴＩＯＮ结构初始化的代码片段．   ｍｅｍｓｅｔ (＆ｇ＿ｃｅｕｎ, ０, ｓｉｚｅｏｆ (ｇ＿ｃｅｕｎ));
    ｇ＿ｃｅｕｎ．ＡｃｔｉｏｎＦｌａｇｓ ＝ ＰＵＮ＿ＤＩＡＬＯＧ;
    ｇ＿ｃｅｕｎ．ｐｗｓｚＤｉａｌｏｇＴｉｔｌｅ ＝ ｓｚＤｌｇＴｉｔｌｅ;
    ｇ＿ｃｅｕｎ．ｐｗｓｚＤｉａｌｏｇＴｅｘｔ ＝ ｓｚＤｌｇＴｅｘｔ;
    ｇ＿ｃｅｕｎ．ｐｗｓｚＳｏｕｎｄ ＝ ｓｚＳｏｕｎｄ;
    ｇ＿ｃｅｕｎ．ｎＭａｘＳｏｕｎｄ ＝ ｓｉｚｅｏｆ (ｓｚＳｏｕｎｄ);
(２)注册用户通知的代码片段:
    ＳＹＳＴＥＭＴＩＭＥ ｓｔ;    ＧｅｔＬｏｃａｌＴｉｍｅ (＆ｓｔ);
    ＧｅｔＭｏｄｕｌｅＦｉｌｅＮａｍｅ (ｈＩｎｓｔ, ｓｚＥｘｅＮａｍｅ, ｓｉｚｅｏｆ (ｓｚＥｘｅＮａｍｅ));
    ｈＮｏｔｉｆｙ ＝ ＣｅＳｅｔＵｓｅｒＮｏｔｉｆｉｃａｔｉｏｎ (０, ｓｚＥｘｅＮａｍｅ, ＆ｓｔ, ＆ｇ＿ｃｅｕｎ);
(３)配置用户通知的代码段:
    ＣｅＧｅｔＵｓｅｒＮｏｔｉｆｉｃａｔｉｏｎＰｒｅｆｅｒｅｎｃｅｓ (ｈＷｎｄ, ＆ｇ＿ｃｅｕｎ);
(４)使用ＣｅＨａｎｄｌｅＡｐｐＮｏｔｉｆｉｃａｔｉｏｎｓ并只运行一个实例(为节省资源)的代码段 :
      ／／判断应用程序的启动是否源于用户通知
ｉｆ(ｌｓｔｒｃｍｐ(ｓｚＴｅｘｔ, ＡＰＰ＿ＲＵＮ＿ＴＯ＿ＨＡＮＤＬＥ＿ＮＯＴＩＦＩＣＡＴＩＯＮ)＝＝０)
 ＧｅｔＭｏｕｄｌｅＦｉｌｅＮａｍｅ(ｈＩｎｓｔ,ｓｚＴｅｘｔ,ｓｉｚｅｏｆ(ｓｚＴｅｘｔ));
 ＣｅＨａｎｄｌｅＡｐｐＮｏｔｉｆｉｃａｔｉｏｎｓ(ｓｚＴｅｘｔ);
ｈＮｏｔｉｆｙ ＝ (ＨＡＮＤＬＥ)＿ｗｔｏｌ(ｐＰｔｒ);  ／／取通知的句柄
／／检查是否已有应用程序的实例在运行
ｈＷｎｄ ＝ ＦｉｎｄＷｉｎｄｏｗ(ＮＵＬＬ,ｓｚＡｐｐＮａｍｅ);
ｉｆ(ｈＷｎｄ)／／如有，向它发送一个自定义消息,由它处理此用户通知
ＳｅｎｄＭｅｓｓａｇｅ(ｈＷｎｄ,ＭＹＭＳＧ＿ＴＥＬＬＮＯＴＩＦＹ,０,(ＬＰＡＲＡＭ)ｈＮｏｔｉｆｙ);
／／终止自身, 代码略去
?妖
     ?妖
(５)使用“定时器事件通知”的代码段:
ＳＹＳＴＥＭＴＩＭＥ ｓｔ;    ＧｅｔＬｏｃａｌＴｉｍｅ (＆ｓｔ);
ＧｅｔＭｏｄｕｌｅＦｉｌｅＮａｍｅ (ｈＩｎｓｔ, ｓｚＥｘｅＮａｍｅ, ｓｉｚｅｏｆ (ｓｚＥｘｅＮａｍｅ));
ＣｅＲｕｎＡｐｐＡｔＴｉｍｅ (ｓｚＥｘｅＮａｍｅ, ＆ｓｔ);
(６)使用“系统事件通知”的代码段:
  ＬＯＮＧ ｌＥｖｅｎｔ;
ｉｆ (ＩｓＤｌｇＢｕｔｔｏｎＣｈｅｃｋｅｄ(ｈＷｎｄ, ＩＤＣ＿ＳＹＮＣ＿ＥＮＤ)＝＝ １)
ｌＥｖｅｎｔ ｜＝ ＮＯＴＩＦＩＣＡＴＩＯＮ＿ＥＶＥＮＴ＿ＳＹＮＣ＿ＥＮＤ;
ｉｆ (ＩｓＤｌｇＢｕｔｔｏｎＣｈｅｃｋｅｄ (ｈＷｎｄ,ＩＤＣ＿ＳＥＲＩＡＬ＿ＤＥＴＥＣＴ)＝＝ １)
ｌＥｖｅｎｔ ｜＝ ＮＯＴＩＦＩＣＡＴＩＯＮ＿ＥＶＥＮＴ＿ＲＳ２３２＿ ＤＥＴＥＣＴＥＤ;
ｉｆ (ＩｓＤｌｇＢｕｔｔｏｎＣｈｅｃｋｅｄ(ｈＷｎｄ,ＩＤＣ＿ＤＥＶＩＣＥ＿ ＣＨＡＮＧＥ)＝＝ １)
ｌＥｖｅｎｔ ｜＝ ＮＯＴＩＦＩＣＡＴＩＯＮ＿ＥＶＥＮＴ＿ＤＥＶＩＣＥ＿ ＣＨＡＮＧＥ;
ｉｆ (ＩｓＤｌｇＢｕｔｔｏｎＣｈｅｃｋｅｄ (ｈＷｎｄ, ＩＤＣ＿ＴＩＭＥ＿ ＣＨＡＮＧＥ) ＝＝ １)
ｌＥｖｅｎｔ ｜＝ ＮＯＴＩＦＩＣＡＴＩＯＮ＿ＥＶＥＮＴ＿ＴＩＭＥ＿ ＣＨＡＮＧＥ;
ｉｆ (ＩｓＤｌｇＢｕｔｔｏｎＣｈｅｃｋｅｄ (ｈＷｎｄ, ＩＤＣ＿ＲＥＳＴＯＲＥ＿ ＥＮＤ) ＝＝ １)
ｌＥｖｅｎｔ ｜＝ ＮＯＴＩＦＩＣＡＴＩＯＮ＿ＥＶＥＮＴ＿ＲＥＳＴＯＲＥ＿ＥＮＤ;
ＧｅｔＭｏｄｕｌｅＦｉｌｅＮａｍｅ (ｈＩｎｓｔ, ｓｚＥｘｅＮａｍｅ,ｓｉｚｅｏｆ (ｓｚＥｘｅＮａｍｅ);
ＣｅＲｕｎＡｐｐＡｔＥｖｅｎｔ (ｓｚＥｘｅＮａｍｅ, ｌＥｖｅｎｔ);
    以上我们介绍了Ｗｉｎｄｏｗｓ ＣＥ Ｎｏｔｉｆｉｃａｔｉｏｎ ＡＰＩ的使用方法，关于Ｗｉｎｄｏｗｓ ＣＥ应用程序开发环境的使用，可参考有关资料[１][２][３][４]。

参考文献
[１]Ｄｏｕｇｌａｓ Ｂｏｌｉｎｇ著，北京博彦科技发展有限公司 译． Ｍｉｃｒｏｓｏｆｔ Ｗｉｎｄｏｗｓ ＣＥ 程序设计．北京：北京大学出版社，１９９９
[２]田东风． ＩｒＳｏｃｋ 红外通讯的原理与实现． 微计算机信息，２００１；（１１）
[３]田东风． ＰＰＣ上的ＭＯＤＥＭ通讯程序设计．微计算机信息，２０００；（２）
[４]田东风． Ｗｉｎｄｏｗｓ ＣＥ应用程序开发实例．软件世界，２０００；（１）
作者简介：田东风，中国地质大学(北京) 信息工程学院副教授，主要研究方向为人工智能，嵌入式系统应用。电话：０１０－８２３２３１８３（Ｏ）。
(１０００８３  北京  中国地质大学信息工程学院) 田东风