1、运国ICS 35. 160 L 60 中华人民共和国国家标准G/T 25654-2010 手持电子产品嵌入式软件APIEmbedded software API for handheld electronic product 2011-04-01实施2010-12-01发布发布中华人民共和国国家质量监督检验检茂总局中国国家标准化管理委员会地飞钱HHS知川内u-56、vg2可气。?70 62 AV J扩盾GR/T 25654-2010 目次前言. . 1 I 范围2 规范性引用文件3 术语和定义、缩略语3. 1 术语和定义3.2 缩略语14 概述5 基础层35.1 RTL函数.5.2 操作系统函
2、数36 应用支撑层46.1 图形人机交互界面46.2 Java接口 54 6. 3 安全546.4 输入法687 应用层717.1 电话功能.7.2 消息类功能787.3 桌面系统867. 4 In ternet编程接口907.5 多媒体1068 数据交换1168. 1 信息交换接口1168.2 数据管理.119 9 电源管理131参考文献. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 GB/T 25654-2010 目。吕本标准由中华人民共和国工业和信息化部提出。本标准由全国信息技术标准化技术委员会(
3、SAC/TC28)归口。本标准起草单位:浙江大学、北京凯思吴鹏软件工程技术有限公司、北京科银京成技术有限公司、中国电子技术标准化研究所、中兴通讯技术有限公司、宁波波导股份有限公司、普天信息技术研究院。本标准主要起草人:吴朝晖、袁玉宇、陈天洲、张肠肠、李允、李云翔、张倪、刘启L兵、王四清、罗营、朱明远、马力、秸智源、黄江伟、戴鸿君、胡戚、赵建东。I GB/T 25654-2010 手持电子产品嵌入式软件API1 范围本标准规定了手持电子产品嵌入式软件API规范。本标准适用于手持电子产品嵌入式软件的设计与开发。2 规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文
4、件，其随后所有的修改版(不包括勘误的内容)或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用艾件，其最新版本适用于本标准。GB/T 1988一件1998信息技术信息交院用七i!.编iWY符集(eqvISO/IEC 646: 1991) GB/T 14246.1-1993 11)忠、技术川l格柏的操作系统界面第1部分:系统应用程序界面(POSIX. 1) (APD (idt ISO/IEC 994 :1 -1 : 199) GB/T 15272-1994 程阵设计语.1C (idt ISO/IH 9899:1990) GB/T 162
5、61.8-2005 f(刀、技术开放系统互连11求第8部分:公钥和属性证书框架OSO/IEC 9594-8: 2001 , IDT) GB/T 220:iB-2008信，白、技术嵌入式系统术语YD/T 1229一-2002可移功终端数据同步协议及节息交换敖据格式技术要求ISO/IEC 11515(所有部分)信息扯术11J移怕操忏系统接口(POSIX)3 术语和定义、缩暗语3. 1 术语和定义GB/T 14246.11993、GBT 1626 .8 20川、G13T 22033-2008中确立的以及下列术语和定义适用于本标准。3. 1. 1 手持电子产晶handhcld electronic p
6、roduct 便于携带，并且可以在移动环境下使用的电子产品。3.1.2 嵌入式数据管理embedded data management 在手持电子产品上，应用计算机数据管理技术，实现对数据的分类、存取、检索等功能。3. 1. 3 动态电源管理(DPM)dynamic power management (DPM) 动态电源管理是指在操作系统运行过程中，动态的根据运行状态，调整系统整体和部分的状态，进行电源管理。3. 1.4 操作点(OPT)operating point (OPT) 由CPU电压、CPU总线频率以及外围设备的状态参数来描述。3.2 缩畸语下列缩略语适用于本标准。API 应用编程接
7、口(ApplicationProgramming Interface) GB/T 25654-2010 AVS CA CRL DOM E岛1A1LFAC GU1 HTML HTTP 岛1CCMID1 孔11肌1E肌1MSMNC P1M P1N POST PUK RTL SM1L SMS SSL Sync肌1LTTS URL UTC WAP WML 引TSPXHT肌1L4 概述数字音视频编解码技术标准(AudioVideo coding Standard) 证书颁发机构CCertificationAuthority) 作废证书列表CCertificate Revocation Lists) 文档
8、对象模型(DocumentObject Model) 电子邮件(electronicmail) 最后的装配号码CFinalAssembly Code) 图形用户接口(GraphicalU ser 1nterface) 超文本置标语言(HyperTextMarkup Language) 超文本传输协议(HypertextTransfer Protocol) 移动电话国家代码CMobileCountry Code) 乐器数字接口(Musical1nstrument Digital 1nterface) 多用途互联网邮件扩展同步多媒体集成语言(Multipurpose1nternet Mail Ex
9、tensions) 多媒体短信服务CMultimediaMessaging Service) 移动电话网络代码CMobileNetwork Code) 个人信息管理CPersonal1nformation Management) 个人识别码CPersonal1dentification Number) 多用途互联网邮件扩展同步多媒体集成语言CMultipurpose1nternet Mail Extensions) 个人解锁码CPersonalUnblocking Code) 实时运行库CRuntimeLibrary) 同步多媒体集成语言CSynchronized Multimedia 1nt
10、egration Language) 短信服务(shortmessage service) 安全套接层CSecuri ty Socket Layer) 同步置标语言(SyncronizationMarkup Language) 语音合成系统(TextTo Speech) 统一资源定位器(Uniform Resource Loca tor) 协调世界时CUniversalTime Coordinated) 元线应用协议CWirelessApplication Protocol) 无线置标语言CWirelessMarkup Language) 无线会话协议(WebService Provide)
11、可扩展超文本置标语言CeXtensibleHyperText Markup Language) 手持电子产品嵌入式软件AP1可以分为基础层AP1、应用支撑层AP1与应用层AP1，其中应用层提供了应用API、数据交换AP1与电源管理AP1，如图1所示。固应用层数据交换包括信息交换、缺入式数据管理应用包括电话、游息、桌面系统、Intemet、多媒体图形人机交互界面、Ja吨接口、安全和输入法应用支撑层RTL与银入式操作系统基础层圄1手持电子产品嵌入式软件API示意图基础层描述了RTL与嵌入式操作系统，提供了系统底层向上层软件的AP1接口。2 GB/T 25654-2010 应用支撑层API标准使得在
12、上层软件开发过程中，可以无需调用基础层API，而在应用支撑层API上进行软件设计。应用支撑层规定了用于手持电子产品的嵌入式软件中应用支撑层所应提供的应用编程接口，包括图形人机交互界面、Java接口、安全和输入法等方面的API。应用层是在应用支撑层之上面向不同领域、不同功能的手持电子产品的典型应用的A凹，包括应用API、数据交换API、电源管理API。应用API规定了手持电子产品应用软件的API规范，如针对移动通讯手持电子产品，定义了电话、短消息等典型应用的编程接口，包括了电话、消息、桌面系统、Internet、多媒体的API。数据交换API为了在手持电子产品的嵌入式软件中实现数据交换，定义了手
13、持电子产品数据管理、交换的编程接口，包括电子名片、电子日历、电话、记事等数据存储交换，以及嵌入式数据管理的API。电源管理API提供了能耗管理的应用编程接口，使用DPM定义了手持电子产品在电源管理方面的API接口，适用于手持电子产品嵌入式软件中的电源管理模块。5 基础层5.1 RTL函数RTL函数是符合GB/T15272-1994实时运行库。根据嵌入式系统的特点以及手持电子产品应用的实际需要，本条规定了RTL中基本的和必须实现的API要求。根据系统的不同实现，GB/T 15272-1994的其他内容可作为本条的可选项。本标准规定的RTL函数如表1所示，函数定义见GB/T15272-1994，函
14、数中涉及的七位编码字符集见GB/T1988-19980 表1RTL函数字符测试函数isalnum、isalpha、lsascl1、iscntrl、isdigit、isgraph、islower、lsprmt、ispunct、lsspace、lsupper、isxdigit存储管理函数calloc、free、malloc、realloc、memchr、memcmp、memcpy、memmove、memset字符串处理函数stncmp、strcat、strchr、strcmp、strcpy、strcspn、strdup，strlen, strnicmp、strncat、strncmp、strncp
15、y、strpbrk、strrchr、strspn、strstr、strtok时间函数asctlme、ctlme、difftime、gettimeofday、gmttme、localtime、mktime、settimeofd町、strftime、time、clock数据转换函数atoi、atol、atof、strtol、strtoul、strtod、tolower、toupper、strupr，strlwr, ecvt、fcvt、gcvtclearer、fclose、fdopen、feof、ferror、fflush、fgetc、ftell、fgets、fileno、fopen、fputc、f
16、puts、fread、输入输出函数freopen、fseek、fsetpos、ftell、fwrite、getc、getchar、gets、putc、putchar、puts、remove、rename、rewind、ungetc、fprintf、fscanf、printf、scanf、sprintf、snprintf、sscanf、vfprintf、vprintf、vsprintf随机数函数rand、srand数学函数abs、acos、asm、atan，ceil、cos、exp、fabs、floor、fmodJabs、log、loglO、modf、pow、sm、sqrt、tan跳转函数lon
17、gjmp、setjmp可变参数va start、va一arg、vaend 5.2 操作系统函数操作系统函数是指用于手持电子产品的单进程多线程的实时嵌入式操作系统。内存管理采用线性内存地址空间。采用虚拟文件系统，把普通文件、目录、设备统一以文件形式进行管理。操作系统API遵循ISO/IEC14515。根据嵌入式系统的特点以及于持电子产品应用的实际需要，本条规定了POSIX中基本的和必须实现的API;根据系统的不同实现，ISO/IEC14515的其他内容可作为本条的可选项。本标准规定的操作系统函数参见ISO/IEC145日，如表2所示。3 GB/T 25654-2010 表2操作系统函数线程函数p
18、thread_create、pthread_detach、pthread_equal、pthread_exit、pthread_join、pthread_selfpthread_attr_ init, pthread_ attr _ destroy、pthread_attr _ getdetachstate、pthread_ attr _ getschedparam、线程属性函数pthread_ attr _ getstackaddr、pthread_ attr _ getstacksize、pthread_ attr _ setdetachstate、pthread_ attr一setsch
19、edparam、pthread_ attr _ setstackaddr、pthread_ attr _ setstacksize 时序控制函数pthread_yield 互斥锁函数pthread _ m u tex _ ini t、pthreadmutt;X_destroy、pthread_mutex_lock、pthread_mutex_ timedlock、pthread_mutex_trylock、pthread_mutex_unlockpthread_mutexa1tr_init、pthread_muttxttr_ destroy、pthread于mutexattr_getkind_
20、 np、pthread一互斥锁属性函数mutexattr setkind _ np、pthread_ mutexattr _ setprotocol、pthread_ mutexattr _ getprotocol、pthread tn utexa tr _ setprioceiling、pthread_ m u texa ttr _getprioceiling 线程私有数据函数pthreldky create、pthread_key_delete、pthread_getspecific、pthread_ sets pecific 信号量sem_c!os町、肥m_destroy、s时ll_ge
21、tvalue时口11mt、町m_open、sem_post、$emtimedwait、sem_trywait、阿munlink、senlVaIt 时钟和定时器盯lock_getres、clock_gcttimc、clock刊tlime，sIPtjJ、timerl!ancel、timr_ connect、tlmer_ create、timer_delete、tlmer一部、tt1mc，t1mer_settlme、旧kcp消息队列mqclose、mq_ gctattr、mq一open、mq_ sell【1、mq_ setattr、mq_ tim(ddreceive、mq_ tinfdsend、mq
22、_unlinkchdir, chmod, cloedir、getcwd、mkd町、opcndir、readdir、rewinddir、rmdir、close、create、dup、文件系统函数dup2 , fcutl、fsync、link、lseek、open、read、sync、write、fslat、fstatfs、ioctl、mknod、mount、stat、statfs、truncate、uD10unt、unlink、ulnH、lItirnc6 应用支撑层6.1 图形人机交互界面6. 1. 1 图形人机交互界面的分层图形人机接口分为3个层次向开发者提供APl以支持不同硬件平台环境的图形
23、开发，分别为图形引擎、窗口机制与图形设备接口以及扩展的控件层。图形引擎层针对frambuHer进行操作，提供基础绘图函数。窗口机制提供遵循Win32消息桶环机制，图形设备接口提供对图形设备的驱动封装，本层API与Win32兼容。控件层提供了各种控件以及控件操作，本层API与Wn32API兼容。6.1.2 图形引擎6. 1. 2. 1 DrawPixel DrawPixel描述如下:函数名DrawPixel 说明在指定的设备上根据指定位置画一个点参数a) 绘图设备结构的描述符b) 点的横坐标c) 点的纵坐标d) 风格设定返回值无4 GB/T 25654-2010 6. 1. 2. 2 DrawL
24、ine DrawLine描述如下:函数名DrawLine 说明在指定两个坐标之间画一条直线参数a) 绘图设备结构的描述符b) 起始点横坐标c) 起始点纵坐标d) 终点横坐标e) 终点纵坐标f) 风格设定返回值无6. 1. 2. 3 DrawRed DrawRect描述如下:函数名DrawRect 说明在指定的设备上根据指定大小画一个矩形参数a) 绘图设备结构的描述符b) 矩形绘图区域c) 颜色d) 风格设定返回值无6. 1. 2. 4 DrawCircle DrawCirce描述如下:函数名DrawCircle 说明在指定设备上根据指定的圆心和半径画圆参数a) 绘图设备结构的描述符b) 圆心横
25、坐标c) 圆心纵坐标d) 圆的半径返回值元6. 1. 2. 5 DrawPoly DrawPoly描述如下:函数名DrawPoly 说明在指定设备上根据指定风格和坐标画一个多边形参数a) 绘图设备结构的描述符b) 多边形的顶点点对c) 风格设定返回值元. 5 GB/T 25654-2010 6. 1. 2. 6 GetDevCapcity GetDevCapcity描述如下:函数名GetDevCapcity 说明取得指定设备的设备信息参数a) 绘图设备结构的描述符b) 存放设备信息结构的描述符返回值指定设备的设备信息6. 1.2. 7 GetPixel GetPixel描述如下:函数名GetP
26、ixel 说明取得指定点的颜色值参数a) 点的横坐标b) 点的纵坐标返回值指定点的32位颜色值6. 1. 2. 8 ScroHScreen ScrollScreeI描述如下:函数名ScrollScreen 说明在指定设备上按指定参数进行屏幕滚动参数a) 绘图设备结构的描述符b) 待滚动的矩形结构的描述符c) 滚动后矩形的左上角位置返回值无6. 1. 2. 9 UpdateScreen U pdateScreen描述如下:函数名U pda teScreen 说明该操作只对非直接写屏设备有效，直接写屏的显示设备不用提供该操作。有业已特别设计的显示设备其显示刷新内存区是不可直接访问的或是只能写而不能
27、读的，这就需要显示设备驱动程序利用一个访问工作内存的操作，在必要时将工作内存用特定方法传送到刷新内存区中。为了避免过量的数据传送，这种设备的驱动程序必须记录下工作内存更新的区域，在必须传送数据时只需传送工作内存中更新区域的内容参数a) 绘图设备结构的描述符b) 刷新区域的描述符返回值无6. 1. 2. 10 OpenDevice OpenDevice描述如下:6 GB/T 25654-2010 函数名OpenDevice 说明打开显示物理设备参数a) 显示设备结构的描述符b) 显示设备的标示符返回值与该设备对应的显示设备结构的长度，为负值表示错误，其绝对值是错误代码6. 1.2. 11 Clo
28、seDevice CloseDevice描述如下:函数名CloseDevice 说明关闭显示设备参数显示设备结构的描述符返回值无6. 1. 2. 12 CreateMemoryDevice CreateMemoryDevice描述如下:函数名CreateMemoryDevice 说明创建一个与物理显示设备显示缓存类似的内存显示设备。用于绘图操作之后快速地写入到物理显示设备上，减少绘图过程中的闪烁参数a) 物理显示设备结构的描述符b) 内存设备的水平像素数c) 内存设备的垂直像素数d) 内存显示设备结构的描述符返回值内存显示设备结构的长度6. 1. 2. 13 DestroyMemoryDevi
29、ce DestroyMemoryDevice描述如下:函数名DestroyMemoryDevice 说明删除一个内存显示设备。结构中有由驱动程序分配的内存区的描述符，将这岛内存区释放参数指向内存设备结构的描述符返回值无6. 1. 2. 14 DIBitBlt DIBitBlt描述如下:函数名DIBitBlt 说明将一个设备无关位图贴到显示设备上参数a) 显示设备结构的描述符b) 设备贴图操作矩形区域的描述符7 GB/T 25654-2010 参数c) 设备无关位图的描述符d) 待贴图的图形左上角在位图中的坐标e) 绘图参数结构的描述符返回值无6. 1.2. 15 TextBlt TextBlt
30、描述如下:函数名TextBlt 说明将文字点阵的单色位图的数据经二元ROP操作之后输出到指定的显示设备上参数a) 物理显示设备或内存显示设备结构的描述符b) 指定在显示设备上输出位置的坐标c) 设备无关位图的描述符d) 绘图参数结构的描述符返回值无6. 1.3 窗口机制层6. 1.3. 1 消息处理6. 1. 3. 1. 1 CallWindowProc Call Window Proc描述如下:函数名CallWindowProc 说明将消息信息传递别指定的窗口函数参数a) 前一个窗口函数b) 指定接收消息的窗口描述符c) 指定消息d) 指定传给窗口函数的参数1e) 指定传给窗口函数的参数2返
31、回值函数调用成功返回消息处理的结果，否则返回06. 1. 3. 1. 2 DispatchMessage DispatchMessage描述如下:函数名DispatchMessage 说明将指定的消息发送到当前窗口的窗口函数参数当前消息结构的描述符返回值返回窗口函数返回的值，这个值取决于实际消息的传送6. 1.3. 1.3 GetMessage GetMessage描述如下:8 函数名GetMessage 说明从消息队列中获取发送给指定窗口的消息参数a) 保存获取到的消息b) 指定窗口c) 指定消息的范围的最小值d) 指定消息的范围的最大值返回值成功/失败6.1.3. 1. 4 Post岛1e
32、ssagePostMessage描述如下-函数名p。再tM古时，ge说明将指定硝息放置到应用程序的消息队列中参数a) 指定接收消息的窗口.b)指定消息类型c) 指定消息的附带参数1d) 指定消息的附带参数2返回值成功/失败6. 1. 3. 1. 5 SendMessage SendMes抽ge描述如下:函数名SendMessage 说明直接发送指定的消息给指定的窗口参数3) /指定接收消息的窗口b)二指定发迭的消息类型c) 指定消息的附带参数1d) 指定消息的附带参数2飞、飞返回值接收消息、的窗口函数处理后的所返回的值，其值由所发送消息决定6. 1. 3. 1. 6 Translate岛1es
33、sageT ransla teMessage描述如下:函数名TranslateMessage GB/T 25654-2010 说明将虚拟键代码消息翻译成字符消息，并将该字符消息加入到消息队列中参数指定虚拟键代码消息返回值成功/失败-6. 1.3. 1. 7 Peek岛1essagePeekMessage描述如下:9 GB/T 25654-2010 函数名PeekMessage 说明在消息队列中查找指定的消息，并进行相应的处理参数a) 指定消息b) 指定接收要查找的消息的窗口c) 指定消息的范围的最小值d) 指定消息的范围的最大值e) 指定如何处理指定的消息(如果找到)，处理方法有以下两种:1)
34、 消息经过查找处理之后不会从队列中删除2) 消息经过查找会从队列中删除返回值成功/失败6. 1. 3. 2 窗口创建6. 1. 3. 2. 1 Create飞布indowCreateWindow描述如下:函数名CreateWindow 说明根据参数所指定的窗口属性创建窗口参数a) 指定窗口类的类名b) 指定窗口的名称c) 指定窗口的格式d) 指定窗口左上角的工坐标e) 指定窗口左上角的y坐标f) 指定窗口的宽度g) 指定窗口的高度h) 指定窗口的父窗口或拥有者窗口指定窗口的菜单或子窗口指定窗口所属的应用程序实例k) 指定传递给要创建的窗口的数据返回值新创建的窗口的描述符/失败6. 1. 3.
35、2. 2 CreateWindowEx Create Window Ex描述如下:函数名Crea te Window Ex 说明根据指定的扩展风格和参数指定的其他窗口属性创建窗口参数a) 指定扩展风格b) 指定窗口类的类名c) 指定窗口的名称d) 指定窗口的格式e) 指定窗口左上角的工坐标f) 指定窗口左上角的y坐标g) 指定窗口的宽度10 GB/T 25654-2010 参数h) 指定窗口的高度指定窗口的父窗口或拥有者窗口j) 指定窗口的菜单或子窗口k) 指定窗口所属的应用程序实例) 指定传递给要创建的窗口的数据返回值新窗口的描述符/失败6. 1. 3. 2. 3 DefWindowProc
36、 DefWindow Proc描述如下:函数名DefWindow Proc 说明对指定窗口的窗口函数不处理的消息进行缺省处理参数a) 指定窗口b) 指定要处理的消息的类型c) 指定消息的附带参数1d) 指定消息的附带参数2返回值返回消息处理结果，具体意义取决于由参数b)指定的消息6. 1. 3. 2. 4 Destroy飞NndowDestroyWindow描述如下:函数名DestroyWindow 说明删除指定的窗口参数指定要删除的窗口返回值成功/失败6. 1. 3. 2. 5 RegisterClass RegisterClass描述如下:函数名RegisterClass 说明根据参数所指
37、定的窗口类信息注册一个新窗口类参数指向包含各种窗口类信息的数据结构返回值成功/失败6. 1. 3. 2. 6 RegisterClassEx RegisterClassEx描述如下:函数名RegisterClassEx 说明根据参数所指定的窗口类信息注册一个新窗口类。本函数的参数所指定的窗口类信息比RegisterClass函数包含更多的内容参数指向包含各种窗口类信息的数据结构返回值成功/失败11 GB/T 25654一20106. 1. 3. 2. 7 UnregisterClass U nregisterClass描述如下:函数名U nregisterClass 说明从窗口类表中注销指定的
38、窗口类参数指定要注销的窗口类返回值成功/失败6. 1.3.2.8 GetClasslnfo GetClasslnfo描述如下:函数名GetClassInfo 说明获取指定窗口类的信息参数a) 指定创建窗口类的应用手里序实例b) 指定窗口类c) 指向用于保存窗口类信息的数据结构返回值成功/失败6. 1.3.2.9 GetClassLong GetClassLong描述如下:函数名GetClassLong 说明从窗口的窗口类结构中获取32作的窗口类信息参数a) 指定要获取类数据的窗口b) 指定要检取的32位值。返回值所要求的32位值/失败6. 1. 3. 2. 1 0 SetClassLon Se
39、tClassLong描述如下:函数名SetClassLong 说明设置窗口的窗口类结构中的32位的窗口信息参数a) 指定要设置类数据的窗口b) 指定要设置的内容c) 指定替换的值返回值指定信息的32位整数的原值/失败6. 1. 3. 2. 11 Get月VindowLongGet Window Long描述如下:函数名Get Window Long 说明获取窗口的信息，该信息是32位的参数a) 指定要获取数据的窗口b) 指定被检取值的偏移量返回值指定的32位整数的原值/失败12 6. 1. 3. 2. 12 SetWindowLong Set Window Long描述如下z函数名Set Wi
40、ndow Long 说明设置窗口的信息，该信息是32位的参数a) 指定要设置数据的窗口b) 指定被检取值的偏移量c) 指定替换的值返回值指定的32位整数的原值/失败6. 1. 3. 3 显示和移动6. 1. 3. 3. 1 MoveWindQwlCTop/ MoveWindowToTop描述如下:函数名MoveWindowToTop 说明把指定的窗口放在重叠窗口堆械的顶部参数指定要移到最上层的窗口返回值成功/失败6. 1. 3. 3. 2 GetClientRect GetClientRect描述如下:函数名GetClientRect 说明1Jt导指定窗口客户区的大小参数a) 指定窗口b) 指
41、向用于保存客户区的矩形尺寸的数据结构返回值成功/失败Icon ControlPanel_DeleteAppIcon描述如下:函数名ControlPanel_DeleteAppIcon 说明删除桌面上的应用程序图标参数指向图标图片的描述符返回值a) 成功，返回实际读取到的记录数b) 失败c) 超时d) 异常7.3.3.6 ControlPanel SetDateTime ControlPanel_SetDateTime描述如下:88 GB/T 25654一2010函数名ControlPanel SetDateTime 说明设置桌面系统的时间和日期参数a) 日期b) 时间返回值a) 成功b) 失败
42、c) 超时d) 异常7.3.3. 7 ControlPanelActiveProfile ControlPanel_Actve Profile描述如下:函数名ControlPanel ActivcProfile 说明激活某一情景院式作为当fJ(19配8如l静音、会议、正常、户外等模式参数将被激活的情景棺式状态_.-嘈-_-可返回值a) 成功b) 失败c) 超时d) 异常7.3.3.8 ControlPanel GetProfile ControlPanel_ GetProfile描述如下:函数名ControlPanel GetProfile 说明获取指定的情景模式的配置一一一宁二一一参数a)
43、指定的情景模式b) 指向情景模式配置结构的结的描述符返回值a) 成功b) 失败c) 超时d) 异常7.3.3.9 ControlPanel SetProfile ControlPan巳l_SetProfile描述如下:函数名ControlPanel SetProfile 说明设置某一情景模式参数a) 将被设置的情景模式b) 指向情景模式配置结构的结构描述符返回值a) 成功b) 失败c) 超时d) 异常89 GB/T 25654-2010 7.3.3. 10 ControlPanel GetNetProfile ControlPanel GetN etProfile描述如下:函数名Control
44、Panel GetN etProfile 说明获得当前网络的设置参数指向网络配置结构的结构描述符返回值成功/失败7. 3. 3. 11 ControlPanel SetNetProfile ControlPanel SetN etProfile描述如下:函数名ControlPanel SetNetProfile 说明设置当前网络参数参数指向网络配置结构的结构描述符返回值成功/失败7. 4 Internet编程接口7.4.1 综述Intern巳t编程接口模型分为3层:解析层、表示层、应用层。在该模型中，底层的模块既是上层的支撑模块，又可以开放出来供应用直接调用。其中，解析层完成对WML、HTML
45、、XHTML文档的解析;表示层实现浏览器网页请求、布局、交互、导航等功能;应用层统一封装了WML、HTML、XHTML这3种文档类型，允许应用创建自己的浏览器对象。7.4.2 HTML/XHTML/WML浏览器应用层接口此应用层接口与底层浏览器承载元关，可以是上述任意一种浏览器或混合型浏览器，或者同时兼容HTML/XHTML/WML的浏览器。浏览器程序对外接口包括两个部分:浏览器的操作命令和浏览器的消息。系统允许多个应用程序同时使用浏览器，每一个应用程序提供自己的消息传送接口，创建自己的浏览器对象。7.4.2.1 浏览器接口函数7. 4. 2. 1. 1 Browser Create Brow
46、ser Create描述如下:函数名Browser Create 说明创建一个浏览器对象。浏览器对象的窗口在指定的父窗口中创建，具有指定的位置和大小参数a) 浏览器窗口的父窗口的描述符b) 浏览器窗口左上角在父窗口中的位置工坐标值c) 浏览器窗口左上角在父窗口中的位置y坐标值d) 浏览器窗口的宽度e) 浏览器窗口的高度返回值a) 浏览器的描述符b) 失败90 GB/T 25654-2010 7.4.2. 1. 2 Browser_Destroy Browser Destroy描述如下:函数名Brows巳r_Destroy说明删除一个浏览器对象参数浏览器对象返回值无7.4.2. 1. 3 Browser_Navigate Browser_Navigate描述如下:函数名Browser_Navigate 说明使浏览器开始浏览一个指定的页面参数a) 浏览器对象的描述符b) 希望浏览的页面的URL字符串的描述符c) 用POST方式发送请求时的POST数据。如果该参数为NULL，表示用GET方式获得页面。如果该页面不是一个HTTP协议的URL，该参数被忽略d) 希望附加发送的HTTP请求头的描述符。该附加的请求头被附带在HTTP标准请求头的后面发送返回值成功/失败7. 4. 2. 1. 4 Browser Refresh Browser_Refresh描
