PowerSys程序员手册-消息驱动接口.pdfVIP

PowerSys 程序员手册 消息驱动访问接口 上海拓启信息技术有限公司 PowerSYS 程序员手册--消息驱动接口 目 录 1 编程概述2 1.1 基本定义2 1.1.1 基本宏定义2 1.1.2 消息响应函数的格式定义4 1.2 属性说明6 2 编程接口6 2.1 头文件及库6 2.2 消息系统的管理6 2.2.1 StartGmsMsgDriver 6 2.2.2 SetGmsMsgGrpDriveMode 7 2.3 消息发送7 2.3.1 本地消息发送7 2.3.2 发送网络消息8 2.4 消息响应 12 2.4.1 StartGmsMessageMap 12 2.4.2 EndGmsMessageMap 12 2.4.3 GetGmsObjID 12 2.5 消息定时器 12 2.5.1 SetGmsTimer 13 2.5.2 SetGmsOnceTimer 13 2.5.3 SetGmsMinuteTimer 13 2.5.4 SetGmsHourTimer 14 2.5.5 SetGmsDayTimer 14 2.5.6 KillGmsTimer 14 2.5.7 KillGmsAllTimer 14 3 例子 15 上海拓启信息技术有限公司 1 PowerSYS 程序员手册--消息驱动接口 1 编程概述 消息驱动访问接口提供对本系统中消息的发送、接收响应的通用接口。该接 口通过多线程并发消息映射方式进行消息处理。 类 CGmsMsgTarget 为消息响应的基类，所有需要响应消息的类均需从该类 派生。 类CGmsTimerObj 为消息定时器的基类，所有需要使用消息定时器的类均需 从该类派生。 消息的发送可分为两种类型：本地消息和网络消息。本地消息指该消息只在 本节点有效，不进行网络传播。而网络消息是指该消息件传播到网络中的所有节 点或部分节点（由消息发送者指定）。 消息的响应通过一系列的宏和CGmsMsgTarget 或CGmsTimerObj 类实现消 息的自动响应，因此调用程序只需将消息与该消息对应的响应函数关联即可，当 消息到达时，系统自动执行该消息的响应函数。为保证消息响应的实时性，本消 息系统的消息驱动可对消息进行分组 （分线程）进行驱动，避免了一般的消息系 统因为一个消息响应时间长导致其它消息得不到及时响应的缺陷。消息调用者也 可以指定该消息在窗口的主进程中响应（对窗口的数据刷新大多采用该方式）。 本消息系统中所有从 CGmsMsgTarget 派生的对象均自动获得一个在本节点 上唯一的ID 号，该ID 号称为消息对象ID 号，用于身份识别。通过GetGmsObjID 可获得该对象的消息对象 ID 号。程序可对指定 ID 的消息对象进行发送消息， 也可对所有消息对象发送消息（广播消息）。消息响应者也可得到消息发送者的 定位信息（包括节点名、进程 ID、消息对象 ID ），所以消息响应