• 3.64 MB
  • 2022-04-22 13:44:23 发布

GBT25654-2010手持电子产品嵌入式软件API.pdf

  • 138页
  • 当前文档由用户上传发布,收益归属用户
  1. 1、本文档共5页,可阅读全部内容。
  2. 2、本文档内容版权归属内容提供方,所产生的收益全部归内容提供方所有。如果您对本文有版权争议,可选择认领,认领后既往收益都归您。
  3. 3、本文档由用户上传,本站不保证质量和数量令人满意,可能有诸多瑕疵,付费之前,请仔细先通过免费阅读内容等途径辨别内容交易风险。如存在严重挂羊头卖狗肉之情形,可联系本站下载客服投诉处理。
  4. 文档侵权举报电话:19940600175。
'ICS35.160L60卣亘中华人民共和国国家标准GB/T25654—2010手持电子产品嵌入式软件APIEmbeddedsoftwareAPIforhandheldelectronicproduct2010—12-01发布2011-04-01实施中华人民共和国国家质量监督检验检疫总局台右中国国家标准化管理委员会捉111 标准分享网www.bzfxw.com免费下载GB/T25654—2010前言⋯⋯⋯···⋯⋯1范围⋯···⋯⋯·2规范性引用文件3术语和定义、缩略语一3.1术语和定义⋯⋯⋯3.2缩略语⋯⋯⋯⋯..4概述··⋯⋯⋯⋯····一5基础层⋯⋯⋯⋯⋯⋯5.1RTL函数⋯⋯⋯一5.2操作系统函数⋯一6应用支撑层⋯⋯·⋯·6.1图形人机交互界面6.2Java接口⋯⋯⋯·6.3安全⋯⋯⋯··⋯⋯··6.4输入法⋯⋯⋯⋯⋯·7应用层⋯⋯⋯⋯⋯⋯·7.1电话功能⋯⋯⋯⋯·7.2消息类功能⋯⋯⋯·7.3桌面系统⋯⋯⋯⋯·7.4Internet编程接口·7.5多媒体⋯⋯·⋯⋯·8数据交换⋯⋯⋯⋯··8.1信息交换接口⋯··8.2数据管理··⋯⋯⋯9电源管理⋯⋯⋯⋯..参考文献目次I●,,●,oo44弘弘鼹n订他%∞∞M¨¨驵踮 www.bzfxw.com前言GB/T25654—2010本标准由中华人民共和国工业和信息化部提出。本标准由全国信息技术标准化技术委员会(SAC/TC28)归口。本标准起草单位:浙江大学、北京凯思吴鹏软件工程技术有限公司、北京科银京成技术有限公司、中国电子技术标准化研究所、中兴通讯技术有限公司、宁波波导股份有限公司、普天信息技术研究院。本标准主要起草人:吴朝晖、袁玉宇、陈天洲、张呖呖、李允、李云翔、张倪、刘胤兵、王四清、罗蕾、朱明远、马力、嵇智源、黄江伟、戴鸿君、胡威、赵建东。 www.bzfxw.com标准分享网www.bzfxw.com免费下载手持电子产品嵌入式软件API1范围本标准规定了手持电子产品嵌入式软件API规范。本标准适用于手持电子产品嵌入式软件的设计与开发。2规范性引用文件GB/T25654—2010下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件,其随后所有的修改版(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本标准。GB/T19881998信息技术信息交换用七位编码字符集(eqvISO/IEC646:1991)GB/T14246.1--1993信息技术可移植的操作系统界面第1部分:系统应用程序界面(POSIX.1)(API)(idtISO/IEC9945—1:1990)GB/T15272—1994程序设计语言C(idtISO/]EC9899:1990)GB/T16264.8—2005信息技术开放系统互连目录第8部分:公钥和属性证书框架(ISO/IEC9594—8:2001,IDT)GB/T22033--2008信息技术嵌入式系统术语YD/T1229--2002可移动终端数据同步协议及信息交换数据格式技术要求Is0/IEc14515(所有部分)信息技术可移植操作系统接口(POSIX)3术语和定义、缩略语3.1术语和定义GB/T14246.1--1993、GB/T16264.8~2005、GB/T22033--2008中确立的以及下列术语和定义适用于本标准。3.1.1手持电子产品handheldelectronicproduct便于携带,并且可以在移动环境下使用的电子产品。3.1.2嵌入式数据管理embeddeddatamanagement在手持电子产品上,应用计算机数据管理技术,实现对数据的分类、存取、检索等功能。3.1.3动态电源管理(DPM)dynamicpowermanagement(DPM)动态电源管理是指在操作系统运行过程中,动态的根据运行状态,调整系统整体和部分的状态,进行电源管理。3.1.4操作点(OPT)operatingpoint(OPT)由CPU电压、CPU总线频率以及外围设备的状态参数来描述。3.2缩略语下列缩略语适用于本标准。API应用编程接口(ApplicationProgrammingInterface)1 www.bzfxw.com数字音视频编解码技术标准(AudioVideocodingStandard)证书颁发机{句(CertificationAuthority)作废{正书列表(CertificateRevocationLists)文档对象模型(Doeun/emOhiemModel)电子邮件fe)ectronicmail)最后的装配号码fFinalAssemblyCode/图形用户接口(GraphiealUserInterface)超文本锭标语言(HyperTextMarkupLanguage)超文本传输胁议(HypertexttransferProtoc01)移动电话国家代码(MobileCountryCode)乐器数字接口(MusicalInstrumentDigitalInterface)多用途互联网邮件扩艟同步多媒体集成语÷(MultipurposeInternetMai多媒悼短信服务(MuhimediaMessagingService)移动电活网络代码(MobileNelwerkCode)个人信息管理(PersonalInformationManagemem)十』、识别毋(PersonalfdemificationNun/her)多用途互联网邮件扩展刊步多媒体集成语言(MultipurposeImernetMai个人解锁码(PersonalUnblockingCode)实时运}r库(RuntimeLihrarylIⅫ步多媒体集成语占(SynchronizedMultimediaImegratienLanguage)短信服务(shortme,sageservice)安令套接层(SecuritySocketLayer)同步置标语.’I(SyneronizationMarkupLanguage)语音合成系统(TexlToSpeech)统一资振定位器(UniformResourceLocater)饰调1#界时(UniversalTimeCoordinated)无线应用协议(WirelessApplicationProtoc01)无线氍标语言(WirelessMarkupanguage)无线会话协议/WebServiceProvide)可扩展超文本置标语言(eXtensibleHyperTextMarkupLanguage)手持电子产品嵌入式软件AI,1可以分为基础层API、应川支撑层API与应用J;API,其中砬片{层提供了出用API、数据交换API与电源管理AI,I.如罔1所示。图1手持电子产品嵌入式软件API示意图摹础层描述了R"I【,与嵌入式操作系统,提供了系统底层向L层软件的At’I接口嚣高黜§l帮器鬻黧鬻赫嚣鬻鬻湍}l醚 www.bzfxw.com标准分享网www.bzfxw.com免费下载GB/T25654—2010应用支撑层API标准使得在上层软件开发过程中,可以无需调用基础层API,而在应用支撑层API上进行软件设计。应用支撑层规定了用于手持电子产品的嵌入式软件中应用支撑层所应提供的应用编程接口,包括图形人机交互界面、Java接口、安全和输入法等方面的API。应用层是在应用支撑层之上面向不同领域、不同功能的手持电子产品的典型应用的API,包括应用API、数据交换API、电源管理API。应用API规定了手持电子产品应用软件的API规范,如针对移动通讯手持电子产品,定义了电话、短消息等典型应用的编程接口,包括了电话、消息、桌面系统、Internet、多媒体的API。数据交换API为了在手持电子产品的嵌入式软件中实现数据交换,定义了手持电子产品数据管理、交换的编程接口,包括电子名片、电子日历、电话、记事等数据存储交换,以及嵌入式数据管理的API。电源管理API提供了能耗管理的应用编程接口,使用DPM定义了手持电子产品在电源管理方面的API接口,适用于手持电子产品嵌入式软件中的电源管理模块。5基础层5.1RTL函数RTL函数是符合GB/T152721994实时运行库。根据嵌入式系统的特点以及手持电子产品应用的实际需要,本条规定了RTL中基本的和必须实现的API要求。根据系统的不同实现,15272—1994的其他内容可作为本条的可选项。本标准规定的RTI。函数如表l所示,函数定义见GB/T152721994,函数中涉及的七位编码字符集见GB/T1988—1998。表1RTL函数字符测试函数isalnum,isalpha,isascii、iscntr/,isdigit、isgraph,islower,isprint、ispunct,isspace,isupper,isxdigit存储管理函数calloc,free?malloc,realloc、memchr,memcmp,memcpy?memmove,memsetstricmp、strcat、strchr,strcmp,strcpy,strcspn、strdupjstrlen、strnicmp,strncat、strnemp、字符串处理函数strncpy、strpbrk、strrchr、strspn、strstr、strtokasetime、crime、difftime,gettimeofday,gmtime?localtime,mktime,settimeofday,strftime,时间函数time、clock数据转换函数atoi,atol,atof,strtol,strtoul、strtod、tolower,toupper,strupr,strlwr,eevt,{evt÷gevtclearer,fclose、fdopen、feof?ferror,fflush、fgete、ftell、fgets?fileno,fopen,fputc,fputs,fread、输入输出函数freopen?fseek、fsetpos?hell、fwrite、getc,getchar、gets,putc?putchar、puts,remove、rename、rewind、ungetc、fprintf、fscanf、printf,seanfjsprintf,snprintfjsscanf、vfprintf、vprintf、vsprintf随机数函数rand、srand数学函数abs?acos?asin,atan、ceil,cos,exp,fabs?floor,fmod,labs,log,logl0,modf、powjsin、sqrt?tall跳转函数Iongjmp、setJmp可变参数vastart、vaarg、vaend5.2操作系统函数操作系统函数是指用于手持电子产品的单进程多线程的实时嵌入式操作系统。内存管理采用线性内存地址空间。采用虚拟文件系统,把普通文件、目录、设备统一以文件形式进行管理。操作系统API遵循IsO/IEc14515。根据嵌入式系统的特点以及手持电子产品应用的实际需要,本条规定了POSIX中基本的和必须实现的API;根据系统的不同实现,IsO/IEc14515的其他内容可作为本条的可选项。本标准规定的操作系统函数参见ISO/1EC14515,如表2所示。 www.bzfxw.comGB/T25654—2010表2操作系统函数线程函数pthreadcreate、pthread—detach、ptkread—equal、pthread—exit、pthreadjoin、pthread—sel{pthrea《attr—ink,pthread—attr.destroy,pthread—attr—getdetachstate?pthread—attr—getschedparam、线程属性函数pthread_attr—getstackaddr、pthread—attr—getstacksize、pthread—attr—setdetachstate、pthread—attr—setschedparam、pthread_attr_setstackaddr、pthread-attr_setstacksize时序控制函数pthreadyieldpthread—mutex—inlt、pthread—mutex—destroy、pthread—mutex—lock、pthread—mutex—timedlock、互斥锁函数pthread—mutex_trylock、pthread—mutex_unlockpthread—mutexattr_init、pthread—mutexattr—destroy、pthread—mutexattr—getkind—np、pthread—互斥锁属性函数mutexattr—setkind—np、pthread—mutexattr—setprotocol、pthreadmutexattr—getprotocol、pthread—mulexattr—setprioeeiling、pthread—rautexattr—getprloeeiling线程私有数据函数pthread—key_create、pthread—key_delete、pthread—getspecific、pthread—setspecifiesem—close、seiil—destroy、sem—gewalue、semjn|t、sem—open、sem—post、sem—timedwait、stem—信号量trywait、sem—unlink、sem—waitcloctgetres,clock—gettime,clock—settime,sleep,timer—cancel,timer—connect,timer—create,时钟和定时器timerdelete、timer—gettime、timer—settime、usleepmq—close、mq—getattr、mq—open、mq—send、mq—setattr、mq—timeddreceive、mq—消息队列timedsend、mq—unlinkchdir,chmod,closedir,getcwd,mkdir,opendir,readdir,rewinddir,rmdir,closejcreate,dup、文件系统函数dup2、fcufl、fsync、link、lseek、open、read、sync、write、{stat、fstatfs、iocfl、mknod、mount、stat、statfs?truncate?umount?unlink?utime?utimes6应用支撑层6.1图形人机交互界面6.1.1图形人机交互界面的分层图形人机接口分为3个层次向开发者提供API以支持不同硬件平台环境的图形开发,分别为图形引擎、窗口机制与图形设备接口以及扩展的控件层。图形引擎层针对framebuffer进行操作,提供基础绘图函数。窗口机制提供遵循Win32消息循环机制,图形设备接VI提供对图形设备的驱动封装,本层API与Win32兼容。控件层提供了各种控件以及控件操作,本层API与Win32API兼容。6.1.2图形引擎6.1.2.1DrawPixelDrawPixel描述如下函数名DrawPixe{说明在指定的设备上根据指定位置画一个点参数a)绘图设备结构的描述符b)点的横坐标c)点的纵坐标d)风格设定返回值无 www.bzfxw.com标准分享网www.bzfxw.com免费下载6.1.2.2DrawLineDrawLine描述如下GB/T25654--2010函数名DrawI,ine说明在指定两个坐标之间画一条直线参数a)绘图设备结构的描述符b)起始点横坐标c)起始点纵坐标d)终点横坐标e)终点纵坐标f)风格设定返回值无6.1.2.3DrawRoctDrawRect描述如下函数名DrawRect说明在指定的设备上根据指定大小画一个矩形参数a)绘图设备结构的描述符b)矩形绘图区域c)颜色d)风格设定返回值无6.1.2.4DrawCircleDrawCircle描述如下函数名DrawCirele说明在指定设备上根据指定的圆心和半径画圆参数a)绘图设备结构的描述符b)圆心横坐标c)圆心纵坐标d)圆的半径返回值无6.1.2.5DrawPolyDrawPo/y描述如下函数名DrawPoly说明在指定设备上根据指定风格和坐标画一个多边形参数a)绘图设备结构的描述符b)多边形的顶点点对c)风格设定返回值无5 www.bzfxw.comGB/T25654—20106.1.2.6GetDevCapcityGetDe,,Capcity描述如下函数名GetDevCapcity说明取得指定设备的设备信息参数a)绘图设备结构的描述符b)存放设备信息结构的描述符返回值指定设备的设备信息6.1.2.7GetPixelGetPixel描述如下函数名GetPixel说明取得指定点的颜色值参数a)点的横坐标‘b)点的纵坐标返回值指定点的32位颜色值6.1.2.8ScrollScreenScrollScreefi描述如下函数名Scr01lScreen说明在指定设备上按指定参数进行屏幕滚动参数a)绘图设备结构的描述符b)待滚动的矩形结构的描述符c)滚动后矩形的左上角位置返回值无6.1.2.9UpdateScreenUpdateScreen描述如下函数名UpdateSereen说明该操作只对非直接写屏设备有效,直接写屏的显示设备不用提供该操作。有些特别设计的显示设备其显示刷新内存区是不可直接访问的或是只能写而不能读的,这就需要显示设备驱动程序利用一个访问工作内存的操作,在必要时将工作内存用特定方法传送到刷新内存区中。为了避免过量的数据传送,这种设备的驱动程序必须记录下工作内存更新的区域,在必须传送数据时只需传送工作内存中更新区域的内容参数a)绘图设备结构的描述符b)刷新区域的描述符返回值无6.1.2.10OpenDeviceOpenDevice描述如下 www.bzfxw.com标准分享网www.bzfxw.com免费下载GB/T25654—2010函数名0penDeviee说明打开显示物理设备参数a)显示设备结构的描述符b)显示设备的标示符返回值与该设备对应的显示设备结构的长度,为负值表示错误,其绝对值是错误代码6.1.2.11CloseDeviceCloseDevice描述如下函数名CloseDeviee说明关闭显示设备参数显示设备结构的描述符返回值无6.1.2.12CreateMemoryDeviceCreateMemoryDevice描述如下函数名CreateMemoryDevice说明创建一个与物理显示设备显示缓存类似的内存显示设备。用于绘图操作之后快速地写入到物理显示设备上,减少绘图过程中的闪烁参数a)物理显示设备结构的描述符b)内存设备的水平像素数c)内存设备的垂直像素数d)内存显示设备结构的描述符返回值内存显示设备结构的长度1.2.13DestroyMemoryDeviceDestroyMemoryDevice描述如下函数名DestroyMemoryDevice说明删除一个内存显示设备。结构中有由驱动程序分配的内存区的描述符,将这些内存区释放参数指向内存设备结构的描述符返回值无6.1.2.14DIBitBitDIBitBlt描述如下函数名DIBitBlt说明将一个设备无关位图贴到显示设备上参数a)显示设备结构的描述符b)设备贴图操作矩形区域的描述符7 www.bzfxw.comGB/T25654--2010参数c)设备无关位图的描述符d)待贴图的图形左上角在位图中的坐标e)绘图参数结构的描述符返回值无6.1.2.15TextBItTextBlt描述如下函数名TextBlt说明将文字点阵的单色位图的数据经二元ROP操作之后输出到指定的显示设备上参数a)物理显示设备或内存显示设备结构的描述符b)指定在显示设备上输出位置的坐标c)设备无关位图的描述符d)绘图参数结构的描述符返回值无6.1.3窗口机制层6.1.3.1消息处理6.1.3.1.1CallWindowProcCallWindowProc描述如下函数名CallWindowProc.说明将消息信息传递到指定的窗口函数参数a)前一个窗口函数b)指定接收消息的窗口描述符c)指定消息d)指定传给窗口函数的参数le)指定传给窗1:3函数的参数2返回值函数调用成功返回消息处理的结果,否则返回06.1.3.1.2DispatchMessageDispatchMessage描述如下函数名DispatchMessage说明将指定的消息发送到当前窗口的窗口函数参数当前消息结构的描述符返回值返回窗口函数返回的值,这个值取决于实际消息的传送6.1.3.1.3GetMessageGetMessage描述如下8 www.bzfxw.com标准分享网www.bzfxw.com免费下载GB/T25654—2010函数名GetMessage说明从消息队列中获取发送给指定窗口的消息参数a)保存获取到的消息b)指定窗口c)指定消息的范围的最小值d)指定消息的范围的最大值返回值成功/失败6.1.3.1.4PostMessagePostMessage描述如下函数名PostMessage说明将指定消息放置到应用程序的消息队列中参数a)指定接收消息的窗口b)指定消息类型c)指定消息的附带参数1d)指定消息的附带参数2返回值成功/失败SendMessage描述如下函数名SendMessage说明直接发送指定的消息给指定的窗口参数a)指定接收消息的窗口b)指定发送的消息类型c)指定消息的附带参数1d)指定消息的附带参数2返回值接收消息的窗口函数处理后的所返回的值,其值由所发送消息决定6.1.3.1.6TranslateMessageTranslateMessage描述如下函数名TranslateMessage说明将虚拟键代码消息翻译成字符消息,并将该字符消息加入到消息队列中参数指定虚拟键代码消息返回值成功/失败PeekMessage描述如下9 GB/T25654—2010函数名PeekMessage说明在消息队列中查找指定的消息,并进行相应的处理参数a)指定消息b)指定接收要查找的消息的窗口c)指定消息的范围的最小值d)指定消息的范围的最大值e)指定如何处理指定的消息(如果找到),处理方法有以下两种:1)消息经过查找处理之后不会从队列中删除2)消息经过查找会从队列中删除返回值成功/失败6.1.3.2窗口创建6.1.3.2.1CreateWindowCreateWindow描述如下函数名CreateWindow说明根据参数所指定的窗I:l属性创建窗口参数a)指定窗口类的类名b)指定窗口的名称c)指定窗口的格式d)指定窗口左上角的z坐标e)指定窗口左上角的Y坐标f)指定窗口的宽度g)指定窗口的高度h)指定窗口的父窗口或拥有者窗口i)指定窗口的菜单或子窗口j)指定窗口所属的应用程序实例k)指定传递给要创建的窗I:1的数据返回值新创建的窗口的描述符/失败6.1.3.2.2CreateWindowExCreateWindowEx描述如下函数名CreateWindowEx说明根据指定的扩展风格和参数指定的其他窗口属性创建窗口参数a)指定扩展风格b)指定窗口类的类名c)指定窗口的名称d)指定窗口的格式e)指定窗口左上角的z坐标f)指定窗口左上角的Y坐标g)指定窗VI的宽度10 标准分享网www.bzfxw.com免费下载GB/T25654—2010参数h)指定窗口的高度i)指定窗口的父窗口或拥有者窗口j)指定窗口的菜单或子窗口k)指定窗口所属的应用程序实例1)指定传递给要创建的窗口的数据返回值新窗口的描述符/失败6.1.3.2.3DefWindowProcDefWindowProc描述如下函数名DefWindowProc说明对指定窗口的窗口函数不处理的消息进行缺省处理参数a)指定窗口b)指定要处理的消息的类型c)指定消息的附带参数1d)指定消息的附带参数2返回值返回消息处理结果,具体意义取决于由参数b)指定的消息6.1.3.2.4DestroyWindowDestroyWindow描述如下函数名DestroyWindow说明删除指定的窗口参数指定要删除的窗口返回值成功/失败6.1.3.2.5RegisterClassRegisterClass描述如下函数名RegisterClass说明根据参数所指定的窗口类信息注册一个新窗口类参数指向包含各种窗口类信息的数据结构返回值成功/失败6.1.3.2.6RegisterClassExRegisterClassEx描述如下函数名RegisterClassEx说明根据参数所指定的窗口类信息注册一个新窗口类。本函数的参数所指定的窗口类信息比RegisterClass函数包含更多的内容参数指向包含各种窗口类信息的数据结构返回值成功/失败 GB/T25654—20106.1.3.2.7UnregisterClassUnregisterClass描述如下函数名UnregisterClass说明从窗口类表中注销指定的窗口类参数指定要注销的窗口类返回值成功/失败6.1.3.2.8GetClassInfoGetClassIMo描述如下函数名GetClassInfo说明获取指定窗El类的信息参数a)指定创建窗口类的应用程序实例b)指定窗口类c)指向用于保存窗口类信息的数据结构返回值成功/失败6.1.3.2.9GetClassLongGetClassLong描述如下函数名GetClassLong说明从窗口的窗口类结构中获取32位的窗口类信息参数a)指定要获取类数据的窗口b)指定要检取的32位值。返回值所要求的32位值/失败6.1.3.2.10SetClassLongSetClassLong描述如下函数名SetClassLong说明设置窗口的窗121类结构中的32位的窗口信息参数a)指定要设置类数据阿窗口b)指定要设置的内容c)指定替换的值返回值指定信息的32位整数的原值/失败1.3.2.11GetWindowLongGetWindowLong描述如下函数名GetWindowLong说明获取窗口的信息,该信息是32位的参数a)指定要获取数据的窗口b)指定被检取值的偏移量返回值指定的32位整数的原值/失败12 标准分享网www.bzfxw.com免费下载6.1.3.2.12SetWindowLongSetWindowLong描述如下GB/T25654—2010函数名SetWindowLong说明设置窗口的信息,该信息是32位的参数a)指定要设置数据的窗口b)指定被检取值的偏移量c)指定替换的值返回值指定的32位整数的原值/失败6.1.3.3显示和移动6.1.3.3.1MoveWindowToTopMoveWindowToTop描述如下函数名MoveWindowToTop说明把指定的窗口放在重叠窗口堆栈的顶部参数指定要移到最上层的窗口返回值成功/失败6.1.3.3.2GetCiientRectGetClientRect描述如下函数名GetClientRect说明获得指定窗口客户区的大小参数a)指定窗口b)指向用于保存客户区的矩形尺寸的数据结构返回值成功/失败6.1.3.3.3GetWindowRectGetWindowRect描述如下函数名GetWindowRect说明获得指定窗口的大小参数a)指定窗口b)指向用于保存窗口的矩形尺寸的数据结构返回值成功/失败6.1.3.3.4GetWindowRectExGetWindowRectEx描述如下l函数名GetWindowRectExl说明获得指定窗口的指定矩形部分的大小 GB/T25654—2010参数a)指定窗口b)指向用于保存函数所获得的矩形尺寸的数据结构c)指出要获得窗口哪一部分的矩形尺寸d)指定矩形坐标的相对位置返回值成功/失败6.1.3.3.5GetWindowTextGetWindowText描述如下函数名GetWindowText说明获得指定窗口的标题参数a)指定窗口b)指定接收文本的缓冲区c)缓冲区可以容纳的最大字符数返回值给出函数实际拷贝的字符串的长度。如果窗口没有标题或标题为空,则返回01.3.3.6GetWindowTextLengthGetWindowTextLength描述如下函数名GetWindowTextLength说明获得指定窗口的标题的长度(以字符计)参数指定窗口返回值标题的长度。如果窗口没有标题或标题为空,则返回06.1.3.3.7SetWindowTextSetWindowText描述如下函数名SetWindowText说明设置指定窗口的标题参数a)指定窗口b)指定要设置的标题文本返回值成功/失败6.1.3.3.8IsWindowVisibleIsWindowVisible描述如下函数名IsWindowVisible说明判断指定窗口是否可见参数指定窗口返回值可见/不可见6.1.3.3.9MoveWindowMoveWindow描述如下14 标准分享网www.bzfxw.com免费下载GB/T25654--2010函数名MoveWindow说明改变指定窗口的大小和位置参数a)指定窗口b)指定窗口左上角的新z坐标c)指定窗口左上角的新y坐标d)指定窗口的新宽度e)指定窗口的新高度f)指定在移动后是否重画窗口返回值成功/失败6.1.3.3.10ShowWindowShowWindow描述如下函数名ShowWindow说明显示或隐藏指定窗口参数a)指定窗口b)指定窗口新的显示状态返回值成功,返回窗口原来的显示状态/失败6.1.3.3.11ShowOwnedPopupsShowOwnedPopups描述如下函数名ShowOwnedPopups说明显示或隐藏属于指定窗口的所有弹出式窗口,参数a)指定窗口b)指定显示还是隐藏弹出式窗口返回值成功/失败6.1.3.4窗口绘制6.1.3.4.1BeginPaintBeginPaint描述如下函数名BeginPaint说明为窗VI的重画做准备。填充由参数b)所指定的数据结构,该结构中包含了与窗口重画有关的信息;并获得绘图时使用的设备描述表参数a)指定即将进行重画操作的窗口b)指定一个可以容纳与窗口重画有关的信息的数据结构返回值绘图时使用的设备描述表的描述符/空6.1.3.4.2GetDCGetDC描述如下 GB/T25654—2010函数名GetDC说明获取指定窗口的客户区的设备描述表。该设备描述表可用于在客户区中绘图参数指定要获取其设备描述表的窗口返回值函数所获取的设备描述表的描述符/失败6.1.3.4.3GetWindowDCGetWindowDC描述如下函数名GetWindowDC说明获取指定窗口的设备描述表。这个设备描述表可用于在整个窗El上绘图参数指定要获取其设备描述表的窗口返回值函数所获取的设备描述表的描述符/失败6.1.3.4.4InvalidateRectInvalidateRect描述如下函数名InvalidateRect说明使指定窗口的指定矩形区域失效。此失效区域将和窗口的原来的更新区域合并,成为响应绘图消息时被重画的区域参数a)指定要增加其失效区域的窗口b)指向放有将失效的区域的尺寸的数据结构c)指定更新区域的背景是否被擦去返回值成功/失败6.1.3.4.5ReleaseDCReleaseDC描述如下函数名ReleaseDC说明释放指定的设备描述表参数a)指定窗口,该窗口的设备描述表将被释放b)指定要释放的设备描述表返回值成功/失败6.1.3.4.6EndPaintEndPaint描述如下函数名EndPaint说明表示在指定窗口中的重画操作结束,本函数必须与BeginPaint函数配合使用参数a)指定窗口b)指向一个数据结构,该数据结构中含有调用BeginPaint函数时获得的信息返回值成功/失败6.1.3.4.7ValidateReetValidateRect描述如下16 标准分享网www.bzfxw.com免费下载GB/T25654—2010函数名ValidateRect说明从指定窗口的更新区域中删除指定的矩形区域参数a)指定其更新域将被修改的窗口b)指向放有区域的尺寸的数据结构返回值成功/失败6.1.3.4.8UpdateWindowUpdateWindow描述如下函数名UpdateWindow说明使指定窗口需要重新绘制的部分被重画参数指定窗口返回值成功/失败6.1.3.5滚动6.1.3.5.1SetScrolllnfoSetScrollInfo描述如下函数名SetScrollInfo说明设置指定滚动条的参数,包括最大值、最小值、页大小和滚动框的位置,并根据需要重画滚动条以反映滚动框的新位置参数a)指定一个滚动条控件或带有滚动条的窗口。是前者还是后者由参数b)的值确定b)指定如何解释参数a)c)指向一个数据结构。该结构中包含滚动条的参数值d)指定是否重画滚动条返回值滚动框的原位置/失败6.1.3.5.2GetScrollInfoGetScrolllnfo描述如下函数名GetScrolllnfo说明获得指定滚动条的参数,包括最大最小滚动位置、页大小和滚动框的位置参数a)指定一个滚动条控件或带有滚动条的窗口。是前者还是后者由参数b)的值确定b)指定如何解释参数a)c)指向一个数据结构。获得的参数值将保存在该结构中返回值成功/失败6.1.3.5.3EnableScrollBarEnableScrollBar描述如下l函数名EnableScrollBarl说明将指定滚动条的一个或两个箭头设置为允许或禁止状态17 GB/T25654—2010参数a)指定一个滚动条控件或带有滚动条的窗口。是前者还是后者由参数b)的值确定b)指定如何解释参数a)c)指定将滚动条的箭头设置为允许还是禁止状态,并指定是哪个或哪些个箭头返回值成功/失败6.1.3.5.4ScrollWindowScrollWindow描述如下函数名ScrollWindow说明滚动指定窗口的客户区中的内容参数a)指定窗口b)指定在水平方向上滚动的像素数c)指定在垂直方向上滚动的像素数d)指向一个数据结构,这个结构描述了一个矩形区域,该个矩形区域指定了将滚动哪部分客户区e)指向一个数据结构,这个结构描述了剪裁矩形的坐标。只有在剪裁矩形中的内容才被滚动返回值成功/失败6.1.3.6窗口信息6.1.3.6.1EHumWindowsEnumWindows描述如下函数名ErluITIWindows说明以屏幕上所有顶层窗VI的描述符做为参数调用指定的回调函数,直到所有顶层窗口已被遍历一遍或回调函数返回“假”为止参数a)指向自定义的回调函数b)指向一个传送给回调函数的32位值‘返回值成功/失败6.1.3.6.2GetWindowGetWindow描述如下函数名GetWindow说明获得与指定窗口有指定关系的窗口描述符参数a)指定一个窗口,要获取其描述符的窗口与该窗口之间存在某种关系,具体关系取决于参数b)的值b)指定参数a)所指定窗口与要获取其句柄的窗口之间的关系返回值函数获得的窗口描述符/不存在与a)所指定窗El具有指定关系的窗口返回失败6.1.3.6.3IsWindowIsWindow描述如下18 标准分享网www.bzfxw.com免费下载GB/T25654—2010函数名IsWindow说明判断指定的窗口是否是一个已存在的窗口参数指定窗口返回值成功/失败6.1.3.6.4GetUserDataGetUserData描述如下函数名GetUsetData说明获取指定窗口的窗口结构中用户数据的起始地址参数指定要获得用户数据起始地址的窗口返回值用户数据的起始地址/失败6.1.3.7资源管理6.1.3.7.1RegisterResourceRegisterRes。urce描述如下函数名RegisterResource说明在使用一个资源之前注册资源参数a)指定资源所属的程序模块的描述符b)指定要注册的资源的资源文件名c)指定资源的描述在整个文件中的偏移d)指定是以文件的格式还是以数据的格式注册资源返回值程序模块的描述符/失败6.1.3.7.2UnRegisterResourceunRegisterRes。urce描述如下函数名UnRegisterResource说明在使用资源之后注销资源参数RegisterResource函数所返回的程序模块描述符返回值成功/失败6.1.3.7.3FindResourceFindResource描述如下函数名FindResouree说明在指定的程序模块中查找具有指定类型和名称的资源参数a)指定程序模块的描述符b)指定资源的名称c)指定资源的类型返回值一个数据结构的描述符(该数据结构中包含查找到资源的信息)/失败 GB/T25654—20106.1.3.7.4LoadResourceLoadResource描述如下函数名LoadResource说明将指定的资源装入内存参数a)标识其可执行文件中包含资源的模块b)指定要装入的资源的描述符返回值a)成功,返回值为包含与此资源相关的数据的全局内存块的设备描述符b)否则,返回值为NULL6.1.3.7.5LoekResourceLockResource描述如下函数名LockResource说明将指定的资源在内存中加锁参数指定将被加锁的资源的描述符返回值a)如果装入资源被加锁,则返回值为该资源首字节的描述符b)返回失败6.1.3.7.6FreeResourceFreeResource描述如下函数名FreeResource说明将已经装载的资源释放参数指定将被删除的资源的描述符返回值a)该资源是以文件的形式装载进来的,返回TRUEb)返回FALSE6.1.3.7.7LoadStringLoadString描述如下函数名LoadString说明装入与指定模块相关的字符串资源,将此字符串拷贝到一个缓冲区中,并附加一个结尾的NULL字符参数a)指定资源所属的模块实例b)指定要装入的字符串的整数标识符c)指向用来接收字符串的缓冲区d)指定缓冲区的大小(按字符计)返回值a)成功,返回值为被拷贝到缓冲区中的字符数目,不包含结尾的NULL字符b)字符串资源不存在,则返回06.1.3.7.8LoadStringPtrL。adSt“ngPtr描述如下 标准分享网www.bzfxw.com免费下载GB/T25654--2010函数名LoadStrirlgPtr说明返回指定模块相关的字符串资源的描述符参数a)指定资源所属的模块实例的设备描述符b)指定要装入的字符串的整数标识符返回值a)成功,返回指向该资源的描述符b)否则,返回NULL6.1.3.7.9LoadlmageLoadImage描述如下函数名LoadImage说明装入光标、图标或位图参数a)指定要装入图像的模块实例b)指定装入图像的名称c)指定图像的类型,包括:位图类型、光标类型、图标类型d)指定图像的宽度(以像素为单位)e)指定图像的高度(以像素为单位)f)指明该图像来自一个特定文件名的文件返回值a)成功,返回刚装入的图像设备描述符b)否则,返回NULL6.1.3.7.10LoadBitmapLoadBitmap描述如下函数名LoadBitmap说明从给定模块的可执行文件中装入指定的位图资源参数a)标识其可执行文件中包含要装人位图的模块实例b)指向一个以NuLL终止的、包含要装入的位图资源名称的字符串。除此之外,该参数还可以在其低位字中包含此资源标识符,在其高位字中置零返回值a)成功,返回刚装入的位图的设备描述符b)否则,返回NULL6.1.3.7.11LoadCursorLoadCursor描述如下函数名LoadCursor说明从与给定应用程序实例相关的可执行文件中装入指定光标资源参数a)标识其可执行文件中包含要装入光标的模块实例b)指向一个以NULL终止的、包含要装入的光标资源的名称的字符串。除此之外,这个参数也可以在其低位字中包含资源标识符,在其高位字中置零返回值a)成功,返回刚装入的光标的设备描述符b)否则,返回NULL GB/T25654--20106.1.3.7.12LoadMenuI,oadMenu描述如下函数名LoadMenu说明装入与给定的应用程序实例相关的的菜单资源参数a)标识其可执行文件中包含要装入菜单的模块实例b)指向一个以NULL终止的、包含要装人的菜单资源名称的字符串。除此之外,该参数还可以在其低位字中包含此资源标识符,在其高位字中置零返回值a)成功,返回刚装入的菜单的设备描述符b)否则,返回NUI。L6.1.3.7.13LoadMenulndirectLoadMenuIndirect描述如下函数名LoadMenuIndirect说明装入指定的菜单模板参数指向一个菜单模板返回值a)成功,返回刚装入的菜单的设备描述符b)否则,返回NULL6.1.3.7.14LoadlconI.oadIcon描述如下函数名LoadIcon说明装入与给定的应用程序实例相关的的图标资源参数a)标识其可执行文件中包含要装入光标的模块实例b)指向一个以NUI,L终止的、包含要装入的图标资源名称的字符串。除此之外,该参数还可以在其低位字中包含此资源标识符,在其高位字中置零返回值a)成功,返回刚装人的图标的设备描述符b)否则,返回NUI。I。6.1.3.8系统函数6.1.3.8.1GetSysColorGetSysColor描述如下函数名GetSysColor说明获取由参数指定的显示元素的缺省系统颜色参数指定要获取颜色的显示元素返回值返回指定显示元素颜色的RGB值6.1.3.8.2GetSystemMetricsGetSystemMetrics描述如下22 标准分享网www.bzfxw.com免费下载GB/T25654—2010函数名GetSystemMetrics说明检取系统度量,系统度量是窗口系统所显示的各种显示单元的宽度和高度参数指定要检取的系统度量,所有度量按像素给出返回值a)成功,返回所求的系统度量b)否则,返回检取失败6.1.3,8.3SetSysColorsSetSysColors描述如下函数名SetSysColors说明改变一个或多个系统颜色参数a)指定改变的系统颜色数b)指向一整数索引数组,该数组指定了将要改变的元素c)指向一个颜色数组,该数组包含了每个元素新的RGB颜色值返回值成功/失败6.1.4图形设备接口6.1.4.1设备描述表6.1.4.1.1CreateCompatibleDCCreateCompatibleDC描述如下函数名CreateCompatibleDC说明创建与指定设备兼容的内存设备描述表参数指定设备描述符返回值a)成功,返回内存设备描述表的设备描述符b)否则,返回NULI.6.1.4.1.2CreateMemoryDCCreateMemoryDC描述如下函数名CreateMemoryDC说明创建内存设备描述表参数a)指定要创建的内存设备描述表的宽度b)指定要创建的内存设备描述表的高度返回值a)成功,返回内存没备描述表的设备描述符b)否则,返回NUI.I.6.1.4.1.3CreateScreenDCCreateScreenDC描述如下函数名CreateScreenDC说明创建屏幕设备描述表参数无返回值a)成功,返回屏幕设备描述表的设备描述符b)否则,返回NUI。L GB/T25654—20106.1.4.1.4DeleteDCDeleteDC描述如下函数名DeleteDC说明删除指定的设备描述表参数指定要删除的设备描述符返回值a)成功,返回TRUEb)否则,返回FALSE6.1.4.1.5GetDeviceCapsGetDeviceCaps描述如下函数名GetDeviceCaps说明检取有关给定设备的特定信息参数a)指定标识设备描述符b)指定返回的项返回值a)成功,返回指定项的值b)失败,返回06.1.4.2绘图工具6.1.4.2.1CreateBrushCreateBrush描述如下函数名CreateBrushIndirect说明创建~个逻辑刷子,这个刷子可由任何设备选择为当前刷子参数a)刷子的样式b)刷子的颜色c)刷子填充效果返回值a)成功,返回创建的逻辑刷子的设备描述符b)否则,返回NULL6.1.4.2.2CreateBrushlndirectCreateBrushIndirect描述如下函数名CreateBrushIndirect说明创建一个具有指定式样、颜色和模式的逻辑刷子参数刷子信息的结构描述符返回值a)成功,返回创建的逻辑刷子的设备描述符b)否则,返回NULL6.1.4.2.3CreateHatehBrushCreateHatchBrush描述如下24 标准分享网www.bzfxw.com免费下载GB/T25654—2010函数名CreateHatchBrush说明创建一个具有指定的阴影图案和颜色的逻辑刷子参数a)指定刷子的阴影类型b)指定刷子的前景颜色(阴影的颜色)返回值a)成功,返回创建的逻辑刷子的设备描述符b)否则,返回NULL6.1.4.2.4CreatePatternBrushCreatePatt盯nBrush描述如下函数名CreatePatternBrush说明创建一个具有内存位图定义图案的逻辑刷子参数指定被用来创建此逻辑刷子的位图的描述符返回值a)成功,返回创建的逻辑刷子的设备描述符b)否则,返回NULL6.1.4.2.5CreatePenCreatePen描述如下函数名CreatePen说明用指定的类型、宽度和颜色创建一个逻辑笔。这个笔能被选择为任何设备的当前笔参数a)笔的类型b)笔的宽度c)笔的颜色(可以使用RGB宏来指定)返回值a)成功,返回创建的逻辑笔的设备描述符b)否则,返回NULL1.4.2.6CreatePenlndirectCreatePenIndlrect描述如下函数名CreatePenIndirect说明创建一个逻辑笔,它具有在给定结构中指定笔的类型、宽度和颜色参数包含指定笔的类型、宽度和颜色的结构的描述符返回值a)成功,返回创建的逻辑笔的设备描述符b)否则,返回NULL6.1.4.2.7CreateSolidBrushCreateSolidBrush描述如下函数名CreateSolidBrush说明创建一个具有指定颜色的逻辑刷子参数指定刷子的颜色返回值a)成功,返回创建的逻辑刷子的设备描述符b)否则,返回NULL25 GB/T25654—20106.1.4.2.8DeleteObjectDeleteObject描述如下函数名DeleteOblect说明删除逻辑画笔、刷子、字库、位图和所有与它们有关的系统资源参数指定要删除的对象设备描述符返回值a)若目标被删除返回值为非0值b)如果参数无效,或者当前被选人设备描述表而没被选出,则返回值为06.1.4.2.9GetObjectGetObject描述如下函数名Getobject说明获得指定对象的有关信息,其内容依赖于对象的类型参数a)标识一对象,可以是下列之一:逻辑位图、笔、刷子或字体b)指定被拷贝到缓冲区的字节数目c)指向用于接收信息的缓冲区返回值a)如果参数c)是一个合法描述符并且函数成功,则返回值为返回的字节数目b)如果参数c)为NUI。L并且函数成功,则返回值为保存对象所需的字节数目;否则返回06.1.4.2.10UnrealizeObjectUnrealizeObject描述如下函数名UnrealizeObject说明重置逻辑调色板参数指明将被重置的逻辑调色板返回值a)成功,返回非0值b)否则返回06.1.4.2.11GetStockObjectGetStockObject描述如下函数名GetStockObject说明该函数获取预定义的画笔、刷子或字体的设备描述符参数指定预定义的对象类型返回值a)成功,返回预定义对象的设备描述符b)否则,返回NUI。L6.1.4.2.12SelectObjectSelectObject描述如下26 标准分享网www.bzfxw.com免费下载GB/T25654—2010函数名Selectobiect说明将一个对象选为当前对象参数a)指定的设备描述符b)标识被选中的对象,可以是下列之一:笔、刷子或字体返回值a)返回值标识了被参数b)指定的对象所替代的旧对象b)函数执行有错,返回NUI。I。6.1.4.2.13SetBrushOrgSetBrushOrg描述如下函数名SetBrushOrg说明为选进给定设备描述表的刷子设置原点参数a)指定设备描述表b)以设备单位指定新画刷原点的z坐标c)以设备单位指定新画刷原点的Y坐标d)指向一个原点结构,该结构接受原画刷原点返回值成功/失败6.1.4.3绘图6.1.4.3.1RectangleRectangle描述如下函数名Rectangle说明画一个矩形,该矩形由当前画笔绘制边框,由当前画刷填充矩形框内的区域参数a)指定绘图设备的描述符b)指定该矩形左上角的z坐标c)指定该矩形左上角的Y坐标d)指定该矩形右下角的32坐标e)指定该矩形右下角的y坐标返回值a)指定点在矩形内,返回成功b)否则,返回失败6.1.4.3.2RoundRectRoundRect描述如下函数名RoundRect说明画一个矩形,该矩形由当前画笔绘制边框,由当前画刷填充矩形框内的区域参数a)指定绘图设备的描述符b)指定该矩形左上角的z坐标c)指定该矩形左上角的Y坐标d)该矩形的宽度e)该矩形的高度27 GB/T25654—2010l返回值a)指定点在矩形内,返回成功b)否则,返回失败6.1.4.3.3DrawTextDrawText描述如下函数名DrawText说明在指定的矩形内显示指定格式的文本参数a)窗口设备描述符b)指定要显示的字符串c)指出要显示的字符串的字符数d)指向矩形区域结构的描述符e)指定文本格式化输出的具体方式返回值a)函数调用成功,返回非0b)否则,返回06.1.4.3.4FillReetFillRect描述如下函数名FillRect说明用指定刷子填充一个给定的矩形参数a)指定绘图设备的描述符b)关于矩形区域结构的描述符,其中包含了要填充的矩形的左上角和右下角的坐标c)标识用于填充矩形的刷子(或指定填充矩形的颜色)返回值成功/失败6.1.4.3.5LineToLineTo描述如下:函数名LineTO说明从当前位置到指定点间用选择的画笔绘制直线参数a)指定绘图设备的描述符b)指定终点的z坐标c)指定终点的Y坐标返回值成功/失败6.1.4.3.6MoveToExMoveTOEXl函数名MOVeTOExl说明把当前位置移到指定点28 标准分享网www.bzfxw.com免费下载GB/T25654—2010参数a)指定绘图设备的描述符b)以逻辑单位指定位置的z坐标c)以逻辑单位指定位置的y坐标d)指向原点的结构,该结构存储原先的当前位置返回值成功/失败6.1.4.4绘图属性6.1.4.4.1GetBkColorGetBkColor描述如下函数名GetBkColor说明返回当前背景颜色参数指定要获得背景颜色的绘图设备返回值当前背景色的RGB颜色值6.1.4.4.2GetBkModeGetBkMode描述如下函数名GetBkMode说明返回当前背景模式参数指定要获得背景模式的绘图设备的描述符返回值返回当前背景模式6.1.4.4.3GetROP2GerrOP2描述如下函数名GetROP2说明获取当前绘图模式参数指定要获得绘图模式的绘图设备的描述符返回值a)成功,返回指定绘图设备的光栅操作码b)失败6.1.4.4.4GetTextColorGetTextColor描述如下函数名GetTextColor说明获取当前的正文颜色参数指定要获得正文颜色的绘图设备的描述符返回值a)成功,返回用一个RGB颜色值给出的文本颜色b)获取失败6.1.4.4.5SetBkColorSetBkColor描述如下29 GB/T25654—2010函数名SetBkColor说明设置背景颜色参数a)指定要设置背景颜色的绘图设备描述符b)指定要设置的背景颜色返回值a)成功,返回值为旧的背景色b)执行中有错,返回设置失败6.1.4.4.6SetBkModeSetBkMode描述如下函数名SetBkMode说明设置背景模式参数a)指定要设置背景模式的绘图设备描述符b)指定要设置的背景模式返回值a)成功,返回旧的背景模式b)失败6.1.4.4.7SetROP2SetROP2描述如下函数名SetROP2说明设置当前绘图模式参数a)指定要设置光栅操作码的绘图设备描述符b)标识新的光栅操作码返回值a)成功,返回旧的光栅操作模式b)失败6.1.4.4.8SetTextColorSetTextColor描述如下函数名SetTextCo[or说明设置正文颜色参数a)指定要设置正文颜色的绘图设备描述符b)指定要设置的正文颜色返回值a)成功,返回原来的正文颜色b)否则,返回设置失败6.1.4.5位图6.1.4.5.1BitBltBitBIt描述如下 标准分享网www.bzfxw.com免费下载GB/T25654—2010函数名BitBlt说明把位图从源设备拷贝到目标设备参数a)指定操作的目的绘图设备的描述符b)指定目标矩形左上角的z坐标c)指定目标矩形左上角的y坐标d)指定源和目的矩形的宽度e)指定源和目的矩形的高度f)指定操作的源绘图设备的描述符g)指定源矩形的左上角的z坐标h)指定源矩形的左上角的y坐标i)指定要执行的光栅操作返回值成功/失败6.1.4.5.2CreateBitmapExCreateBitmapEx描述如下函数名CreateBitmapEx说明创建一个有给定宽度、高度和颜色格式的位图参数a)以像素为单位的位图的宽b)以像素为单位的位图的高c)该设备使用的色平面的数目d)标识单个像素的颜色所要求的位数e)当f)为真时,此参数指定位图数据缓冲区;若为假时,是一个用于在像素矩形中设置颜色数据的数组,矩形中的每个扫描行必须是双字节对齐的;如果此参数是NULL,标识未定义新位图f)指定参数e)是否是一个位图数据缓冲区返回值a)成功,返回创建的位图的设备描述符b)失败,返回NULL6.1.4.5.3CreateBitmaplndirectCreateBitmapIndirect描述如下函数名CreateBitmapIndirect说明创建一个在数据结构中描述的位图参数指向一个包含有关位图信息的结构返回值a)成功,返回创建的位图的设备描述符b)失败,返回NUI。L6.1.4.5.4CreateCompatibleBitmapCreateCompatibleBitmap描述如下31 GB/T25654—2010函数名CreateCompatibleBitmap说明创建一个与指定设备兼容的位图参数a)指定绘图所需的绘图设备b)指定位图的宽度c)指定位图的高度返回值a)成功,返回创建的位图的设备描述符b)失败,返回NULl。6.1.4.5.5DrawBltmapFromDataDrawBitmapFromData描述如下函数名DrawBitmapFromData说明在指定设备上绘制兼容位图参数a)指定绘图所需的绘图设备描述符b)指定输出位置的z坐标c)指定输出位置的Y坐标d)指定位图的宽度e)指定位图的高度f)该设备使用的色平面的数目g)标识单个像素的颜色所要求的位数h)指向一个用来设置像素矩形中颜色的颜色数据数组i)指定光栅操作码返回值成功/失败6.1.4.5.6DrawBitmapFromFileDrawBitmapFromFile描述如下函数名DrawBitmapFromFile说明根据位图文件在指定设备上绘制位图参数a)指定绘图所需的绘图设备描述符b)指定输出位置的z坐标c)指定输出位置的Y坐标d)指定位图文件的名称e)指定光栅操作码返回值成功/失败6.1.4.5.7PatBltPatBlt描述如下l函数名PatBltI说明创建位图32 标准分享网www.bzfxw.com免费下载GB/T25654—2010参数a)指定绘图所需的绘图设备描述符b)指定要填充区域的左上角z坐标c)指定要填充区域的左上角y坐标d)指定要填充区域的宽度e)指定要填充区域的高度f)指定要执行的光栅操作,可以是二元光栅操作或三元光栅操作返回值成功/失败6.1.4.5.8SetBitmapBitsSetBitmapBits描述如下函数名SetBitmapBits说明设置位图中各个位的值参数a)指定要设置的位图的描述符b)指出由参数c)指向的数组的字节数c)指向一个字节的数组,其中存放给定位图的颜色返回值a)成功,返回设定位图中的位所用的字节数b)否则,返回06.1.4.5.9StretchBItStretchBlt描述如下函数名StretchBh说明把位图从源设备拷贝到目标设备(如果需要,则进行压缩或放大)参数a)指定目的设备描述符b)以逻辑单位指定目的矩形的左上角的z坐标c)以逻辑单位指定目的矩形的左上角的,坐标d)以逻辑单位指定目的矩形的宽度e)以逻辑单位指定目的矩形的高度f)指定源设备描述符g)以逻辑单位指定源矩形的左上角的z坐标h)以逻辑单位指定源矩形的左上角的y坐标i)以逻辑单位指定源矩形的宽度j)以逻辑单位指定源矩形的高度k)指定将要实现的光栅操作返回值成功/失败1.4.5.10CreateDIBitmapCreateDIBitmap描述如下函数名CreateDIBitmap说明使用设备无关位图(DIB)的格式创建一个设备指定的内存位图,并可对位图中的位进行初始化,该函数与创建位图函数相似 GB/T25654—2010参数a)指定设备描述符b)指向一个位图信息头的结构c)指定如何创建位图d)指向包含初始位图数据的字节数组e)指向一个位图信息的结构f)指定数据结构的成员是否已被初始化返回值成功/失败6.1.4.5.11GetDIBitsGetDIBits描述如下函数名GetDIBits说明获取以设备无关形式表示的指定位图在内存中的位参数a)指定设备描述符b)指定标识位图描述符c)指定要检取的第一条扫描线d)指定要检取的扫描线数目e)指向接收位图数据的缓冲区f)指向一个位图信息结构g)指定位图信息结构中位图颜色结构成员的格式返回值a)成功,返回值为从位图中拷贝的扫描线数目b)否则,返回值为NULL6.1.4.5.12SetDIBitsSetDIBits描述如下函数名SetDIBits说明通过DIB设置内存位图中的位参数a)指定设备描述符b)指定位图描述符,将使用给定DIB中的颜色数据修改该位图c)指定参数e)指向的数组中的设备无关颜色数据的起始扫描行d)指定含有设备无关颜色数据的数组中的扫描行的总数e)指向DIB的颜色数据f)指向一个位图信息数据结构,该结构存放关于DIB的信息g)指出是否提供了位图信息结构的成员返回值a)成功,返回实际设置的扫描行数b)否则,返回06.1.4.5.13SetDIBitsToDeviceSetDIBitsToDevice描述如下 标准分享网www.bzfxw.com免费下载GB/T25654—2010函数名SetDIBitsToDevice说明在设备上给定的矩形中设置像素,该设备与使用设备无关位图(D/B)颜色数据的目的设备描述表相联系参数a)指定设备描述符b)以逻辑单位指定目的矩形的左上角的32坐标c)以逻辑单位指定目的矩形的左上角的y坐标d)以逻辑单位指定的DIB的宽度e)以逻辑单位指定的DIB的高度f)以逻辑单位指定的DIB左上角的z坐标g)以逻辑单位指定的DIB左上角的y坐标h)指定DIB中的起始扫描行i)指定参数j)指向的数组中存放的DIB的扫描行数j)指向DIB的颜色数据。颜色数据以字节数组存放k)指向一个位图信息数据结构,该结构存放关于DIB的信息1)指出是否提供了位图信息结构的成员返回值成功/失败6.1.4.5.14StretchDIBitsStretchDIBits描述如下函数名StretchDIBits说明将设备无关位图的颜色数据拷贝到目的矩形,扩展或压缩位图以使其适合目的矩形的范围参数a)指定设备描述符b)以逻辑单位指定目的矩形的左上角的z坐标c)以逻辑单位指定目的矩形的左上角的∥坐标d)以逻辑单位指定目的矩形的宽度e)以逻辑单位指定目的矩形的高度f)以逻辑单位指定源矩形的左上角的z坐标g)以逻辑单位指定源矩形的左上角的y坐标h)以逻辑单位指定源矩形的宽度i)以逻辑单位指定源矩形的高度j)指定设备无关的位数据k)指定数据结构的成员是否已被初始化1)指定将要实现的光栅操作返回值a)成功,返回实际拷贝的行数b)失败6.1.4.6文本6.1.4.6.1GetTextAlignGetTextAlign描述如下 GB/T25654—2010函数名GetTextAlign说明获取正文对齐方式参数指定设备描述符返回值a)成功,返回文本对齐标志的状态b)失败6.1.4.6.2GetTextExtentGetTextExtent描述如下函数名GetTextExtent说明使用当前字体计算正文行的宽度和高度参数a)指定设备描述符b)指向文本串c)指定字符串中字符个数d)指向一个尺寸结构,返回该结构中的字符串尺寸返回值成功/失败6.1.4.6.3GetTextMetricsGetTextMetrics描述如下函数名GetTextMetrics说明获取当前字体的属性参数a)指定设备描述符b)用于接收度量的结构返回值成功/失败6.1.4.6.4SetTextAlignSetTextAlign描述如下函数名SetTextAlign说明设置正文的对齐方式参数a)指定设备描述符b)指定掩码,通过掩码指定文字对齐返回值a)成功,返回值为原文字对齐设置b)否则,返回失败6.1.4.6.5TextoutTextOut描述如下l函数名TextoutI说明用当前字体显示字符串 标准分享网www.bzfxw.com免费下载GB/T25654—2010参数a)指定绘图所需的绘图设备的描述符b)指定字符串的逻辑z坐标c)指定字符串的逻辑y坐标d)指定该字符串的字符数返回值成功/失败6.1.4.7字库6.1.4.7.1CreateFontCreateFont描述如下函数名CreateFont说明创建具有指定特征的逻辑字库参数a)指定所要求字体的字符单元的高度或字符所期望的高度(用逻辑单位)b)指定所要求的字体中的字符的平均宽度(用逻辑单位计)c)指定倾斜度矢量与设备的z轴之间的角度(以1/10度为单位)d)指定每个字符基线与设备的z轴之间的角度(以1/lo度为单位)e)指定字体所需的深浅程序f)如果此参数设置为真,则指定字体为斜体g)如果此参数设置为真,则指定字体的字符要加下划线h)如果此参数设置为真,则指定字体的字符要加删除线i)指定所要求的字符集j)所要求的字体高度、宽度、字符方向,倾斜度和间距k)指定需要的剪辑精度1)指定所要求的输出质量m)指定字体的字符间距和字体家族n)字体的字样名,以NuLL结束返回值a)成功,返回一个逻辑字体的设备描述符b)否则,返回NULL6.1.4.7.2CleateFontlndirectCreateFontIndirect描述如下函数名CreateFontlndirect说明创建具有指定特征的逻辑字库参数指定一个定义了逻辑字体特征的结构的描述符返回值a)成功,返回逻辑字体的设备描述符b)否则,返回NULL6.1.4.8输入6.1.4.8.1GetActiveWindowGetActiveWindow描述如下37 GB/T25654—2010函数名GetActiveWindow说明获取当前活动窗口的窗口设备描述符参数无返回值a)成功,返回活动窗口的设备描述符b)没有一个活动窗口,则返回NUI。L6.1.4.8.2GetCapture函数名GetCapture说明返回捕获到鼠标事件的窗口参数无返回值a)当前存在捕获鼠标事件的窗口,返回其设备描述符b)没有一个活动窗口,返回NUI。L6.1.4.8.3EnableWindowEnableWindow描述如下函数名EnableWindow说明允许或禁止给定窗口或控件接收鼠标和键盘的输入参数a)指定要被允许或禁止的窗口的描述符b)指定是允许还是禁止窗口返回值a)窗口原先是禁止的,返回成功b)否则,返回失败6.1.4.8.4GetFoCUSGetFocus描述如下函数名GetFOCUS说明获取当前拥有输入焦点的窗口参数无返回值a)成功,返回值为与调用线程有关的键盘焦点窗口的设备描述符b)调用线程不包含键盘焦点窗口,返回值为NULL6.1.4.8.5lsWindowEnabledIsWindowEnabled描述如下函数名IsWindowEnabled说明确定指定窗口是否允许接收鼠标和键盘输入参数指定的窗口设备的描述符返回值a)此窗口允许鼠标和键盘输入,返回成功b)否则,返回失败 标准分享网www.bzfxw.com免费下载6.1.4.8.6UngrabPenUngrabPen描述如下GB/T25654—2010函数名UngrabPen说明恢复正常的鼠标输入处理参数指定的窗口设备的描述符返回值成功/失败6.1.4.8.7SetActiveWindowSetActiveWindow描述如下函数名SetActiveWindow说明使指定的窗口成为活动窗13参数指定的窗口设备的描述符返回值a)成功,返回值为原来的活动窗口设备描述符b)否则,返回NULI。6.1.4.8.8GrabPenGrabPen描述如下函数名GrabPen说明使所有鼠标输入送到指定窗口参数指定的要捕获笔输入的窗口设备描述符返回值无6.1.4.8.9SetFocusSetFocus描述如下函数名SetFOCUS说明赋予指定窗口输入焦点参数窗口设备描述符返回值a)成功,返回原来具有输入焦点的窗口设备描述符b)否则,返回NUI。I。6.1.4.8.10SetTimerSetTimer描述如下:函数名SetTimer说明用指定的时限值创建一个定时器参数a)指定与定时器相联系的窗口设备描述符b)指定一个非0的定时器标识符c)以毫秒为单位指定时限值d)指向到时后将被通知的函数 GB/T25654--2010l返回值a)成功,返回值为标识该定时器的整数,应用程序可将这一值,或(存在的)字符串标识符传递给撤销定时器函数以毁掉该定时器b)若函数创建定时器失败,则返回06.1.4.8.11KⅢTimerKillTimer描述如下函数名KillTimer说明撤销指定的定时器事件参数a)指定与指定的定时器相关的窗口设备描述符b)指定要删除的定时器返回值成功/失败6.1.5控件集6.1.5.1菜单6.1.5.1.1CreateMenuCreateMenu描述如下函数名CreateMenu说明创建一个空菜单参数无返回值a)调用成功,返回新建菜单的设备描述符b)调用失败,返回NULL6.1.5.1.2CreatePopupMenuCreatePopupMenu描述如下函数名CreatePopupMenu说明创建一个弹出式菜单参数无返回值a)成功,返回新建菜单的设备描述符b)失败,返回NULL6.1.5.1.3DestroyMenuDestroyMenu描述如下函数名DestroyMeIIU说明销毁给定的菜单,并释放该菜单所占用的内存参数要销毁的菜单描述符返回值成功/失败6.1.5.1.4AppendMenuAppendMenu描述如下40 标准分享网www.bzfxw.com免费下载GB/T25654--2010函数名AppendMenu说明在指定的菜单的尾部添加一个新的菜单项参数a)菜单描述符b)菜单项外观和行为的标志c)菜单项的标识符d)菜单项的内容返回值成功/失败6.1.5.1.5ChangeMenuChangeMenu描述如下函数名ChangeMenu说明在指定的菜单中插入、修改、删除一个指定菜单项参数a)指定将要修改的菜单描述符b)指定将要变化的菜单项c)指定新菜单项的内容d)指定操作的类型e)参数中可以设置的标志返回值成功/失败6.1.5.1.6CheckMenultemCheckMenuItem描述如下函数名CbeckMenuItem说明设置或取消菜单项的选中标记参数a)指定将要修改的菜单描述符b)指定设置状态的菜单项,具体动作由c)参数决定c)指定如何解释b)参数返回值成功/失败6.1.5.1.7DeleteMenuDeleteMenu描述如下函数名DeleteMenu说明删除一个菜单项并删除任何与之有关的弹出式菜单参数a)要删除的菜单的描述符b)指定要删除的菜单项,由c)参数决定c)指定如何解释b)参数返回值成功/失败6.1.5.1.8EnableMenultemEnableMenultem描述如下41 GB/T25654—2010函数名EnableMenultern、说明激活或禁止一个菜单项参数a)标识将要修改的菜单描述符b)指定允许、禁止或变灰显示的菜单项,具体动作由c)参数决定c)指定如何解释b)参数返回值成功/失败6.1.5.1.9DrawMenuBarDrawMenuBar描述如下函数名D/TawMenuBar说明重绘菜单条参数指定其菜单条需要重新绘制的窗口描述符返回值成功/失败6.1.5.1.10GetMenuGetMenu描述如下函数名GetMenu说明获取指定窗口的菜单描述符参数指定窗口描述符返回值a)函数调用成功,返回菜单描述符b)如果给定窗El没有菜单,则返回NULL5.1.11GetMenultemCountGetMenultemCount描述如下函数名GetMenultemCount说明确定给定菜单条或弹出式菜单中的菜单项数参数菜单描述符返回值a)成功,返回菜单中的菜单项数b)否则,返回失败6.1.5.1.12GetMenultemlDGetMenultemlD描述如下函数名GetMenultemID说明获取菜单项的标识符参数a)菜单描述符b)指定被检取标识符的菜单项的位置(以0为基数)返回值a)函数调用成功,返回指定菜单项的标识符b)如果此标识符为NUI。I。,或此菜单项激活了一个弹出菜单,则返回失败42 标准分享网www.bzfxw.com免费下载6.1.5.1.13GetMenuStateGetMenuState描述如下GB/T25654—2010函数名GetMenuState说明获取菜单项的状态(是否选中、变灰、禁止)参数a)菜单描述符b)指定被检取其标志的菜单项,其意义由c)参数决定c)指定如何解释b)参数返回值a)如果菜单项不存在,则返回失败b)如果此菜单项激活一个弹出菜单,则返回值的低位字节包含与此菜单项有关的菜单标志,而其高位字节包含由此菜单项激活的弹出式菜单的菜单项数目c)否则,返回值是各菜单标志的一个掩码(布尔OR)6.1.5.1.14GetMenuStringGetMenuString描述如下函数名GetMenuString说明获取指定菜单项的名称参数a)菜单描述符b)指定被检取的菜单项,其意义由e)参数决定c)指定缓冲区d)字符串的最大长度e)指定如何解释b)参数返回值a)成功,返回指定被拷贝到缓冲区中的字符数目,不包括结尾的NUI—I一字符b)否则,返回06.1.5.1.15GetSubMenuGetSubMenu描述如下函数名GetSubMenu说明获取弹出菜单的菜单描述符参数a)菜单描述符b)指定激活弹出式菜单的菜单项在给定菜单中的位置(以0为基)返回值a)函数调用成功,返回被此菜单项激活的弹出式菜单的描述符b)若此菜单项不激活一个弹出式菜单,则返回NULL6.1.5.1.16InsertMenuInsertMenu描述如下43 GB/T25654—2010函数名InsertMenu说明在菜单中的某个位置插入一个菜单项参数a)菜单描述符b)指定新菜单项要插入在其前的菜单项,由c)参数确定c)控制对b)参数的解释,指定标志以控制新菜单项的外观和行为d)指定新菜单项的标识符e)指定新菜单项的内容返回值成功/失败6.1.5.1.17IsMenuIsMenu描述如下;函数名IsMenu说明判断指定描述符是否是菜单描述符参数指定描述符返回值成功/失败6.1.5.1.18ModifyMenuModifyMenu描述如下函数名ModifyMenu说明修改某个指定菜单项参数a)菜单描述符b)指定新菜单项要插入在其前的菜单项,由参数c)确定c)控制对参数b)的解释,指定标志以控制新菜单项的外观和行为d)指定新菜单项的标识符e)指定新菜单项的内容返回值成功/失败RemoveMenu描述如下函数名RemoveMenu说明从菜单中清掉一菜单项但并不删除它参数a)菜单描述符b)指定删除的菜单项,具体动作由参数c)决定c)指定如何解释参数b)返回值成功/失败6.1.5.1.20SetMenultemBitmapsSetMenuItemBitmaps描述如下44 标准分享网www.bzfxw.com免费下载GB/T25654—2010函数名SetMenuItemBitmaps说明把给定位图同一个菜单项联系起来。无论菜单项是被选择的还是未被选择的,系统都将在该菜单项旁显示适当位图参数a)指定将要修改的菜单描述符b)指定要改变的菜单项,具体动作由参数c)决定c)指定如何解释参数b)d)当菜单未被选择时所显示的位图e)当菜单被选择时所显示的位图返回值成功/失败6.1.5.1.21SetMenuSetMenu描述如下函数名SetMeDU说明为窗口指定新菜单参数a)指定的窗口描述符b)指定的菜单描述符返回值成功/失败6.1.5.1.22TrackPopupMenuTrackPopupMenu描述如下函数名TraekPopupMenu说明在指定位置显示弹出式菜单参数a)将要显示的弹出式菜单描述符b)指定菜单的对齐方式c)以屏幕坐标指定弹出式菜单的水平位置d)以屏幕坐标指定弹出式菜单的顶部的垂直位置e)保留,必须为0f)指定拥有该弹出式菜单的窗口g)矩阵结构存放一个矩形的屏幕坐标返回值成功/失败6.1.5.1.23GetMenuCbeckMarkDimensionsGetMenuCheckMarkDimensions描述如下函数名GetMenuCheckMarkDimensions说明返回缺省检查记号位图的尺寸参数无返回值返回值指定缺省检查记号的像素高度和宽度。其高位字包含高度,低位字包含宽度6.1.5.1.24HiliteMenultemHiliteMenuItem描述如下45 GB/T25654—2010函数名HiliteMenuhem说明对一菜单栏中的菜单项高亮或删除高亮参数a)包含此菜单的窗口描述符b)指定将要修改的菜单描述符c)指定要被增亮的菜单项d)控件参数的解释的标志,并指示此菜单项是否被增亮返回值成功/失败6.1.5.2对话框6.1.5.2.1CheckDlgButtoncheckDlgButton描述如下函数名CheckDlgButton说明设置或清除复选按钮选中标记参数a)指定包含该按钮的对话框的描述符b)指定要修改的按钮的标识符c)指定该按钮的选择状态返回值成功/失败6.1.5.2.2CheekRadioButtonCheckRadioButton描述如下函数名CbeckRadioButton说明选中一个指定单选按钮并去掉所有其他单选按钮的选中标记参数a)指定包含单选框的对话框的描述符b)指定按钮组中第一个单选框的标识符c)指定按钮组中最后一个单选框的标识符d)指定被选中的单选框的标识符返回值成功/失败6.1.5.2.3CreateDialogCreateDialog描述如下函数名CreateDialog说明从程序定义的对话框模板创建一个无模式对话框参数a)指定应用程序实例b)指定对话框模板c)指定拥有对话框的窗口描述符d)指向对话框函数返回值a)成功,返回对话框的描述符b)否则,返回失败46 标准分享网www.bzfxw.com免费下载6.1.5.2.4CreateDialogIndirectCreateDialoglndirect描述如下GB/T25654--2010函数名CreateDialogIndirect说明该函数从内存中的一个对话框模板中创建一个无模式对话框参数a)指定应用程序实例b)指向内存中一个用于创建对话框的模板c)指定拥有对话框的窗VI描述符d)指向对话框的窗口函数返回值a)成功,返回对话框的描述符b)否则,返回失败6.1.5.2.5CreateDialogParamCreateDialogParam描述如下函数名CreateDialogParam说明从程序定义的对话框模板中创建一个无模式对话框,并在创建时把数据传给它参数a)指定应用程序实例b)指定对话框模板c)指定拥有对话框的窗I:1描述符d)指向对话框的窗口函数e)指定发送对话框初始化消息时的参数值返回值a)成功,返回对话框的描述符b)否则,返回失败6.1.5.2.6CreateDialoglndirectParamCreateDialogIndirectParam描述如下函数名CreateDialogIndirectParam说明该函数从内存中的一个对话框模板中创建一个无模式对话框,并在创建时把数据传给它参数a)指定应用程序实例的描述符b)指向内存中一个用于创建对话框的模板c)指定拥有对话框的窗口描述符d)指向对话框的窗口处理函数e)指定以对话框初始化消息的参数传递给对话框的值返回值a)成功,返回对话框的描述符b)否则,返回失败47 GB/T25654—20106.1.5.2.7DefDIgProcDefDlgProc描述如下函数名DefDlgProc说明为属于应用程序定义的对话框类的窗口过程实现缺省的消息处理参数a)指定的对话框的描述符b)指定消息标识c)指定消息的附带参数1d)指定消息的附带参数2返回值返回值指定了消息处理的结果,它取决于实际发送的消息成功DialogBox描述如下函数名DialogBox说明从程序定义的对话框模板创建一个模式对话框参数a)指定包含对话框模板的应用程序实例b)指定对话框模板的名字,或者是一个指定对话框模板的资源标识符的整数值c)指定拥有对话框的窗口描述符d)指向对话框的窗口处理函数返回值a)用成功,返回值为函数6.1.5.2.12EndDialog中参数b)值,EndDialog函数用来终止对话框b)否则,返回失败6.1.5.2.9DialogBoxlndirectDialogBoxIndirect描述如下函数名DialogBoxIndirect说明从内存中的一个对话框模板中创建模式对话框参数a)指定包含对话框模板的应用程序实例b)指向内存中一个用于创建对话框的模板c)指定拥有对话框的窗口描述符d)指向对话框的窗口处理函数返回值a)成功,返回值为函数6.1.5.2.12EndDialog中参数b)的值,EndDialog函数用来终止对话框b)否则,返回失败6.1.5.2.10DialogBoxParamDialogBoxParam描述如下48 标准分享网www.bzfxw.com免费下载GB/T25654—2010函数名DialogBoxParam说明从程序定义的对话框模板创建模式对话框,并在创建时把数据传给它参数a)指定包含对话框模板的应用程序实例b)指定对话框模板的名字,或者是一个指定对话框模板的资源标识符的整数值c)指定拥有对话框的窗口描述符d)指向对话框的窗口处理函数返回值a)成功,返回值为函数6.1.5.2.12EndDialog中参数b)的值,EndDialog函数用来终止对话框b)否则,返回失败G.1.5.2.11DialogBoxIndirectParamDialogBoxlndirectParam描述如下函数名DialogBoxIndirectParam说明从内存中的一个对话框模板中创建模式对话框,并在创建时把数据传给它参数a)指定包含对话框模板的模块的实例b)指向内存中一个用于创建对话框的对话框模板c)指定拥有对话框的窗口描述符d)指向对话框的窗口处理函数返回值a)用成功,返回值为函数6.1.5.2.12EndDialog中参数b)的值,EndDialog函数用来终止对话框b)否则,返回失败G.1.5.2.12EndDiaiogEndDialog描述如下函数名EndDialog说明销毁一个模式对话框,并使系统终止对此对话框的任何处理参数a)对话框描述符b)指定从创建对话框的函数返回到应用程序的值返回值成功/失败G.1.5.2.13GetDIgCtrlIDGetDlgCtrlID描述如下函数名GetDlgCtrlID说明获取控件的标识符参数控件的描述符返回值a)成功,返回此控件的标识符b)否则,返回NUI,I,49 GB/T25654--20106.1.5.2.14GetDlgltemGetDlgItem描述如下函数名GetDlgItem说明获取对话框中一个指定控件的描述符参数a)对话框描述符b)要被检取的控件的标识符返回值a)成功,返回给定控件的窗口描述符b)否则,返回NULL6.1.5.2.15GetDlgltemTextGetDlgItemText描述如下函数名GetDlgItemText说明获取对话框中某个控件的标题或文本内容参数a)对话框描述符b)要检取其标题或文本的控件标识符c)接收标题或文本的缓冲区d)被拷贝到缓冲区中的字符串长度。如果该字符长度超过限制,则该串被截断返回值a)成功,返回指定被拷贝到缓冲区中的字符数目,不包括终止的NULL字符b)否则,返回失败6.1.5.2.16GetNextDIgGroupltemGetNextDlgGroupItem描述如下函数名GetNextDlgGroupItem说明获取指定对话框中位于指定控件之前(或之后)的第一个控件的描述符参数a)对话框描述符b)指定用作查找起始点的控件c)指定该函数将如何查找对话框中的控件组返回值a)成功,返回查找到的控件描述符b)否则,返回NULL6.1.5.2.17GetNextDIgTabItemGetNextDlgTabItem描述如下函数名GetNextDlgTabltem说明获取指定控件之前(或之后)的第一个具有Tabstop风格的控件描述符参数a)对话框描述符b)指定用作查找起始点的控件c)指定该函数将如何查找对话框中的控件组返回值成功/失败 标准分享网www.bzfxw.com免费下载6.1.5.2.18IsDialogMessageIsDialogMessage描述如下GB/T25654—2010函数名IsDialogMessage说明判断指定消息是否是给定对话框所期望的,如果是则处理此消息参数a)对话框描述符b)指定消息描述符返回值a)如果该消息是给定对话框消息,返回成功b)否则,返回失败6.1.5.2.19IsDlGButtonCheckedIsDlgButtonChecked描述如下函数名IsDlGrButtonChecked.说明判断一个按钮控件是否选中参数a)对话框描述符b)指定控件的标识符返回值a)按钮状态未被选择b)按钮状态被选择c)按钮状态不确定d)返回失败6.1.5.2.20lslnputMessageIsInputMessage描述如下函数名[sInputMessage说明判断一条消息是否是鼠标或键盘消息参数指定消息码返回值a)是鼠标或键盘消息,返回成功b)否则,返回失败‘6.1.5.2.21SendDlgItemMessageSendDlgltemMessage描述如下函数名SendDlgltemMessage说明发送一条消息给指定对话框中的指定控件参数a)对话框描述符b)指定接收消息的控件标识符c)指定要发送的消息d)指定消息的附带参数1e)指定消息的附带参数2返回值返回值指定消息的处理结果并依赖于所发送的消息51 GB/T25654—20106.1.5.2.22SetDlgltemTextSetDlgItemText描述如下函数名SetDlgItemText说明设置对话框中某个控件的标题或文字参数a)对话框描述符b)要设置其标题或文字的控件标识符c)指向一个以NULL结束的字符串,该字符串是要拷贝到控件中的文字返回值成功/tt败6.1.5.2.23MessageBoxMessageBox描述如下函数名MessageBox说明创建、显示并操作一消息框。此消息框包含一条应用程序定义的消息和标题,以及任意组合的预定义图标和按钮参数a)指定要创建的消息框的属主窗口的描述符b)指向一个以NULL终止的、包含要显示的消息的字符串c)指向一个以NULL终止的、用作此消息框标题的字符串d)指定对话框的内容和动作返回值如果没有足够的内存创建消息框,则返回值为0;否则,返回值由对话框返回6.1.5.3剪贴板6.1.5.3.1RegisterClipboardFormatRegisterClipboardFormat描述如下函数名RegisterClipboardFormat说明登记一个新的剪贴板格式。这个格式以后被用作一个有效的剪贴板格式参数指向一个以NULL结束的字符串,该字符串是新格式的名称返回值a)成功,返回标识被登记的剪贴板格式b)否则,返回失败6.1.5.3.2GetClipboardFormatNameGetClipboardFormatName描述如下函数名GetClipboardFormatName说明该函数从剪贴板中检取指定的已注册的格式名称。该函数将此名称拷贝到指定缓冲区中参数a)指定被检取格式的类型。这个参数不可以指定任何预定义的剪贴板格式b)指向接收此格式名称的缓冲区c)指定可被拷贝到缓冲区中的字符串的最大字符长度。如果此格式名称超出这个限制,则名称被截断返回值a)成功,则返回值为被拷贝到缓冲区中的字符串的字符长度b)否则,返回失败52 标准分享网www.bzfxw.com免费下载6.1.5.3.3OpenClipboardOpenClipboard描述如下GB/T25654—2010函数名0penClipboard说明打开剪贴板参数指定与打开的剪贴板相联系的窗口描述符返回值成功/失败6.1.5.3.4CloseCIip·boardCloseClipboard描述如下函数名CloseClipboard说明关闭剪贴板参数无返回值成功/失败6.1.5.3.5GetClipboardDataGetclipb。ardData描述如下函数名GetClipboardData说明从剪贴板中取出数据参数指定一种剪贴板格式返回值a)成功,返回指定格式的一剪贴板对象的描述符b)否则,返回值为NULL6.1.5.3.6SetClipboardDatasetclipboardData描述如下函数名SetClipboardData说明设置剪贴板中数据参数a)指定一种已登记的剪贴板格式.b)指定格式数据的描述符返回值a)成功,返回数据的描述符b)否则,返回NULL1.5.3.7EmptyClipboardEmptyClipboard描述如下函数名EmptyClipboard说明清空剪贴板并释放剪贴板中数据参数无返回值成功/失败53 GB/T25654—20106.1.5.3.8IsClipboardFormatAvailableIsCliphoardFormatAvailable描述如下:函数名IsClipboardFormatAvailable说明判断剪贴板中是否有可使用的给定格式的数据参数指定一种剪贴板格式返回值a)剪贴板格式可用,返回成功b)否则,返回失败6.2Java接口本标准中定义的Java接口要求参见JSR30、JSR37、JSRll8、JSRl20、JSRl35、JSRl39、JSRl72、JSRl79、jsRl84和JSRl85。6.3安全6.3.1概述安全分为SSL协议、数字证书和算法三个部分。其中SSL协议层包含握手过程的建立以及对用户数据进行封装和解封,并为用户提供编程接口;数字证书包含所有对数字证书的处理以及证书库的管理;算法层包含了所有涉及到的公钥算法和对称加密算法,结构如图2所示。SSL协议模块利用数字证书来完成对服务器端的认证工作,并利用算法模块提供的算法完成密钥交换、加/解密用户数据以及利用单向散列函数来完成MAC(消息完整性检查)。对于数字证书,需要利用算法来提供可认证的属性。一图2嵌入式软件安全框架数字证书和算法模块可以各自是一个单独的模块,并不是专门针对SSL的,可以向外提供独立接口。6.3.2SSL协议接口6.3.2..SSL—initSSL—init描述如下函数名SSLinit说明完成整个SSL协议栈的初始化工作参数初始化参数。若为NUI,L,则使用缺省参数返回值成功/错误信息 标准分享网www.bzfxw.com免费下载6.3.2.2SSL—openSSL—open描述如下GB/T25654—2010函数名SSLopen说明申请并按照缺省参数初始化一个安全会话参数本地网络地址返回值a)成功时返回安全会话标识符b)失败则返回相应的出错信息6.3.2.3SSLconnectSSL—connect描述如下函数名SSLconnect说明建立一个安全连接参数a)安全会话标识符b)要连接的对端网络地址,包括IP和端口返回值成功/错误信息6.3.2.4SSLwriteSSL—write描述如下函数名SSLwrite说明发送数据到已建立的安全连接对端参数a)安全会话标识符b)要发送的数据c)要发送的数据长度返回值a)成功时返回成功发送的字节数b)出错时返回错误信息6.3.2.5SSLreadSSL—read描述如下函数名SSLread说明从已建立的安全连接读人数据参数a)安全会话标识符b)数据c)数据大小返回值a)成功时返回成功发送的字节数b)出错时返回错误信息6.3.2.6SSL—closeSSL—close描述如下 GB/T25654—2010函数名SSLclose说明关闭一个安全连接参数安全会话标识符返回值成功/错误信息6.3.2.7SSL—stateSSL—state描述如下函数名SSLstate说明返回指定会话的状态参数安全会话标识符返回值连接的状态:连接关闭、正在建立连接、连接已经建立6.3.2.8SSL—ioctlSSL—ioctl描述如下函数名SSLioctl说明对会话和连接参数进行控制参数a)安全会话标识符b)操作类型(读/写):设置或是读取参数c)操作的选项类型:是否验证服务器证书,设置会话可重用性,会话可以容忍的最大警告错误信息数目,加密套接字,压缩方法,会话超时,会话生存时间,用户自定义的证书验证回调,非阻塞方式,阻塞方式,接收缓冲大小d)选项e)选项大小返回值成功/错误信息6.3.3公开密钥算法接口6.3.3..ENC—CIPHER—CTX—createENC—CIPHER—CTXcreate描述如下函数名ENcCIPHERCTX—create说明创建并初始化公开密钥的数据结构参数无返回值a)成功时,返回公开密钥数据结构的描述符b)NULL 标准分享网www.bzfxw.com免费下载6.3.3.2ENC—CIPHER—CTX—destroyENC—CIPHER—CTX—destroy描述如下GB/T25654--2010函数名ENC——CIPHER——CTX——destroy说明释放公开密钥的数据结构参数公开密钥数据结构的描述符返回值无6.3.3.3ENCClPHERCTXinitENC—CIPHER—CTX—init描述如下函数名ENC——CIPHER——CTX——init说明初始化公开密钥的数据结构参数需要初始化的公开密钥数据结构的描述符返回值无6.3.3.4ENC—CIPHER—CTX_eleanupENC—CIPHER_CTX—cleanup函数名ENC——CIPHER——CTX——cleanup说明清除公开密钥数据结构中的内容并释放描述符型成员所指向的存储区参数公开密钥数据结构的描述符返回值成功/错误信息6.3.3.5ENC—CIPHER-CTX—set—paddingENC—CIPHER—CTX—set—padding描述如下函数名ENC——CIPHER——CTX.—set——padding说明设置公开密钥数据结构对应的某对称算法是否支持padding功能参数a)公开密钥数据结构的描述符b)是否支持padding:不等于0表示支持padding,否则表示不支持padding返回值成功/错误信息6.3.3.6ENC—CIPHER—CTX—set—key—lengthENCCIPHER—CTX—set—key—length描述如下函数名ENC——CIPHER——CTX——set——key——length说明设置公开密钥数据结构中某对称算法的密钥长度参数a)公开密钥数据结构的描述符b)密钥长度返回值成功/错误信息6.3.3.7ENC—SealloitENC—Seallnit描述如下57 GB/T25654—2010函数名ENCSealInit说明使用输入的公钥序列加密,针对某算法随机生成的会话密钥以及初始化向量参数a)公开密钥数据结构的描述符b)对称加密算法标识符c)公钥序列缓冲区的描述符d)公钥个数e)加密后会话密钥缓冲区的描述符f)加密后会话密钥的长度g)随机生成的初始化向量缓冲区的描述符返回值成功/错误信息6.3.3.8ENC—SealUpdateENCSealUpdate描述如下函数名ENC—SealUpdate说明用对称加密算法加密明文参数a)公开密钥数据结构的描述符b)明文缓冲区的描述符c)明文长度d)密文缓冲区的描述符e)密文长度返回值成功/错误信息6.3.3.9ENCSealFinalENC—SealFinal描述如下函数名ENC-SealFinal说明加密明文中的最后一个分块并输出其对应的密文参数a)公开密钥数据结构的描述符b)密文缓冲区的描述符c)密文长度返回值成功/错误信息6.3.3.10ENC—OpenInitENC—OpenInit描述如下函数名ENC0penlnit说明使用私钥解密已用对应公钥加密的会话密钥以及未加密的初始化向量参数a)公开密钥数据结构的描述符b)对称加密算法标识符c)加密后的会话密钥缓冲区的描述符58 标准分享网www.bzfxw.com免费下载GB/T25654—2010参数d)加密后的会话密钥长度e)初始化向量缓冲区的描述符f)指向公钥序列缓冲区的描述符返回值成功/错误信息6.3.3.11ENC—OpenUpdateENC—OpenUpdate描述如下函数名ENC一0penUpdate说明用对称加密算法解密密文参数a)公开密钥数据结构的描述符b)明文缓冲区的描述符c)密文长度‘d)明文缓冲区的描述符e)明文长度返回值成功/错误信息6.3.3..2ENC—OpenFinalENC—OpenFinal描述如下函数名ENC—OpenFinal说明解密密文中的最后一个分块并输出其对应的明文参数a)公开密钥数据结构的描述符b)明文缓冲区描述符c)明文长度返回值成功/错误信息6.3.3.”ENC—PubKEY—encryptENC—PubKEY—encrypt描述如下函数名ENC——PubKEY——encrypt说明用指定公钥加密明文参数a)明文缓冲区的描述符b)明文长度c)公钥序列缓冲区的描述符d)存放密文的缓冲区的描述符返回值密文长度/错误信息6.3.3..4ENC—PubKEY—decryptENC—PubKEY—decrypt描述如下59 GB/T25654—2010函数名ENC。—PubKEY——decrypt说明用指定公钥解密密文参数a)密文缓冲区的描述符b)密文长度c)公钥序列缓冲区的描述符d)存放明文的缓冲区的描述符返回值明文长度/错误信息6.3.3.15ENC—PriKEY—encryptENcPriKEY—encrypt描述如下函数名ENC——PriKEY——encrypt说明用指定私钥加密明文参数a)明文缓冲区的描述符b)明文长度c)公钥序列缓冲区的描述符d)存放密文的缓冲区的描述符返回值密文长度/错误信息6.3.3-16ENC—PriKEY—decryptENC—PriKEY—decrypt描述如下函数名ENC——PriKEY——decrypt说明用指定私钥解密密文参数a)密文缓冲区的描述符b)密文长度c)公钥序列缓冲区的描述符d)存放明文的缓冲区的描述符返回值明文长度/错误信息6.3.4对称算法接口6.3.4..ENC—CipherlnitENC—Cipherlnit描述如下函数名ENC—Cipherlnit说明初始化对称算法数据结构参数a)对称算法数据结构的描述符b)对称加密算法标识符c)对称加密算法密钥缓冲区的描述符d)对称加密算法初始化向量缓冲区的描述符e)加解密标识:加密、解密返回值成功/错误信息60 标准分享网www.bzfxw.com免费下载6.3.4.2ENC—EncryptInitENC—EncryptInit描述如下GB/T25654—2010函数名ENC—EncryptInlt说明设置用于加密的数据结构参数a)对称算法数据结构的描述符b)对称加密算法标识符c)对称加密算法密钥缓冲区的描述符d)对称加密算法初始化向量缓冲区的描述符返回值成功/错误信息6.3.4.3ENC—EncryptUpdateENC—EncryptUpdate描述如下函数名ENC—EncryptUpdate说明利用已经设置好的对称算法加密明文参数a)对称算法数据结构的描述符b)明文缓冲区的描述符c)明文长度d)密文缓冲区的描述符e)密文长度返回值成功/错误信息6.3.4.4ENC—EncryptFinalENC—EncryptFinal描述如下函数名ENC——EncryptFinal说明加密明文中的最后一个分块并输出其对应的密文参数a)对称算法数据结构的描述符b)密文缓冲区的描述符c)密文长度返回值成功/错误信息6.3.4.5ENC—DecryptlnitENC—DecryptInit描述如下函数名ENC—Decrypt][nit说明设置用于解密的数据结构参数a)对称算法数据结构的描述符b)对称加密算法标识符c)对称加密算法密钥缓冲区的描述符d)对称加密算法初始化向量缓冲区的描述符返回值成功/错误信息61 GB/T25654—20106.3.4一ENC—DecryptUpdateENC—DecryptUpdate描述如下函数名ENC—DecryptUpdate说明利用已经设置好的对称算法解密密文参数a)对称算法数据结构的描述符b)密文缓冲区的描述符c)密文长度d)明文缓冲区的描述符e)明文长度返回值成功/错误信息6.3.4.7ENC—DecryptFinalENC—DecryptFinal描述如下函数名ENC-DecryptFinal说明解密密文中的最后一个分块并输出其对应的密文参数a)对称算法数据结构的描述符‘b)密文缓冲区的描述符c)密文长度d)明文缓冲区的描述符e)明文长度返回值成功/错误信息6.3.5证书接口6.3.5.1CertStoreCreateCertStore—Create描述如下函数名CertStore—Create说明创建一个证书库参数a)证书库类型b)选项c)选项参数返回值成功/错误信息6.3.5.2CertStore—DuplicateCertStore—Duplicate描述如下函数名CertStore——Duplicate说明复制证书库参数被复制的证书库描述符返回值复制成功返回证书库的标识符/错误信息62 标准分享网www.bzfxw.com免费下载6.3.5.3CertStore_DestoryCertStoreDestory描述如下GB/T25654—2010函数名CertStore—Destory说明删除一个证书库参数要删除的证书库描述符返回值成功/错误信息5一CertObj—ImportToStoreCertObi—ImportToStore描述如下函数名CertObj—ImportToStore说明导入一个证书到证书库参数a)证书库标识符b)要导人的证书编码c)编码类型d)编码长度返回值生成的证书对象的描述符/NULL5.5CertObj—GetFirstFromStoreCertObj—GetFirstFromStore描述如下函数名CertObj—GetFirstFromStore说明获得指定的证书库的第一个证书参数证书库标识符返回值证书库的第一个证书描述符/NULL6.3.5一CertObj—GetNextFromStoreCertObj—GetNextFromStore描述如下函数名CertObi—GetNextFromStore说明获得指定证书库中指定证书的下一个证书参数a)证书库标识符b)证书对象描述符返回值证书5.7CertObj—DeleteFromStoreCertObj—DeleteFromStore描述如下函数名CertObjDeleteFromStore说明从指定的证书库中取出一个证书参数a)证书库标识符b)要取出的证书对象描述符返回值无63 GB/T25654—20106.3.5.8CertObj—EnumInStoreCertObj—EnumlnStore描述如下函数名CertObj—EnumInStore说明获得指定的证书库中证书对象的个数参数证书库标识符返回值证书库中证书个数/错误信息6.3.5.9CertObj—FreeCertObj—Free描述如下函数名CertObj—Free说明释放一个证书对象参数a)要释放的证书对象描述符b)证书对象类型返回值无6.3.5.10CERTCreateContextCERTCreateContext描述如下函数名CERT—CreateContext说明为指定的证书创建数据结构参数a)要转换的证书b)证书编码类型c)证书编码长度d)创建的证书结构描述符返回值成功/错误信息6.3.5.11CERTRefContextCERT—RefContext描述如下函数名CERT—RefContext说明引用指定的证书参数要引用的证书描述符返回值可引用的证书描述符6.3.5.12CERTFreeContextCERT—FreeContext描述如下函数名CERT—FreeContext说明释放指定证书的数据结构参数要释放的证书描述符返回值无 标准分享网www.bzfxw.com免费下载6.3.5.13CERTExportCERT—Export描述如下GB/T25654—2010函数名CERTExport说明按照指定格式编码输出证书参数a)证书描述符b)编码格式c)输出缓冲区d)输出缓冲区长度返回值成功/错误信息6.3.5..4CERT—DisplayContextCERT—DisplayC。ntext描述如下函数名CERTDisplayContext说明显示证书内容参数a)要显示的证书描述符b)显示设备返回值成功/错误信息6.3.5.15CERTgetPublicKeyCERT—getPublicKey描述如下函数名CERT—getPublicKey说明获取指定证书的公钥参数证书描述符返回值公钥描述符/NULL6.3.5.16CertChain_InternalVerifyCertChain—InternalVerify描述如下函数名CertChain—InternalVerify说明系统验证指定的证书链函数参数a)要验证的证书链b)使用的可信任证书库c)对端证书(即证书链中第一个证书)的公钥返回值成功/错误信息6.3.5..7CertChain—CreateCertChain—Create描述如下65 GB/T25654—2010函数名CertChain—Create说明创建证书链结构参数a)要解析的编码证书链描述符b)编码证书链中证书个数返回值证书链描述符/NULL6.3.5..8CertChain—DuplicateCertChainDuplicate描述如下函数名CertChain—Duplicate说明复制指定的证书链参数要复制的证书链返回值复制出的证书链描述符/NULL6.3.5.19CertChainFreeCertChain—Free描述如下函数名CertChain—Free说明释放指定的证书链空间参数要释放的证书链描述符返回值无6.3.5.20CertVerify_TimeValidCertVerify—TimeValid描述如下函数名CertVerify—TimeVa[id说明验证证书的时间有效性参数a)要验证的证书b)时间格式c)时间基准值返回值无6.3.5.21CertVerify—TimeNestingCertVerify_TimeNesting描述如下函数名CertVerify_TimeNesting说明验证证书的有效期是否在其颁发者的有效期内参数a)要验证的证书b)颁发者证书返回值成功/错误信息6.3.5.22CertVerify_SignatureValidCertVerify—SignatureValid描述如下66 标准分享网www.bzfxw.com免费下载GB/T25654—2010函数名CertVerify——SignatureValid说明验证证书的签名参数a)要验证的证书b)验证使用的公钥返回值成功/错误信息5.23CertVerify—CRLValidCertVerify—CRLValid描述如下函数名CertVerify——CRLValid说明验证证书是否被CRL撤销参数a)要验证的证书b)CRL证书库标识符返回值成功/错误信息6.3.5.24CRLCreateContextCRL—CreateContext描述如下函数名CRL—CreateContext说明为指定的CRL创建数据结构参数a)要转换的证书b)证书编码类型c)编码长度d)CRL数据结构的描述符返回值成功/错误信息6.3.5.25CRLRefContextCRL—RefContext描述如下函数名CRL—RefContext说明引用指定的CRL数据结构参数要引用的CRL描述符返回值成功/NULL6.3.5.26CRLFreeContextCRL—FreeContext描述如下函数名CRL—FreeContext说明释放指定CRL的数据结构参数要释放的CRL描述符返回值无67 GB/T25654—20106.3.5.27CRL—DisplayContextCRL—Displaycontext描述如下函数名CRL—DisplayC。ntext说明显示指定的CRL信息参数a)要显示的证书描述符b)显示设备返回值成功/错误信息6.3.5.28CRL—ExportCRLExport描述如下函数名CRLExport说明按照指定的编码格式输出CRL参数a)CRL描述符b)编码格式c)输出缓冲区d)输出缓冲区长度返回值成功/错误信息6.4输入法6.4.1概述手持电子产品上,使用的输入法按输入方式分为键盘输入法和手写输入法2大类。本条主要定义键盘输入法引擎的API接口。由于语音识别技术正在迅速发展,本章将保留语音输入法的接口。定义接口模型如图3所示。图3输入法引擎接口模型图6.4.2输入法接口函数6.4.2.1概述接口函数是系统提供给输入法以及应用程序调用的函数,本条主要定义系统提供给输入法的接口函数。6.4.2.2ImmRegilsterlmeImmRegisterIme描述如下: 标准分享网www.bzfxw.com免费下载GB/T25654--2010函数名ImmRegisterlme说明注册输入法,将一种输入法添加到系统中,系统能够调用该输入法接口参数指向输入法人口结构类型的结构描述符返回值成功/失败6.4.2.3lmmUnregisterlmeImmUnregisterIme描述如下函数名ImmUnregisterIme说明卸载输入法,从系统中删除输入法的注册信息参数已添加到系统中的输入法名称返回值成功/失败6.4.3输入法回调函数6.4.3.1概述输人法回调函数是输入法在注册时,输入法提供给系统的接El,并由系统调用。6.4.3.2IME—HandlekeyIME—Handlekey描述如下函数名IME—Handlekey说明输入法按键处理函数参数a)传递键值。键值的传递分为2种:1)基于按键的键值传递。即每次传递一个键值进入输入法,输入法内部保留并处理此键值2)基于序列的键值传递。即每次传递一系列的有效键值组合进入输入法,输人法部保存该键值序列,只对键值序列进行处理b)处理结果回调结构体,取回处理参数a)后所对应的结果。如果没有对应的值,则返回NULL或错误代码返回值成功/失败6.4.3.3IME—InitializeIME—Initialize描述如下函数名IMEInitialize说明初始化输入法。设置输入法初始参数,包括初始输入法类型、公用变量等参数无返回值成功/失败6.4.3.4IME—SelectlmeIME—Selectlme描述如下69 GB/T25654—2010函数名IMESelectIme说明根据传递的参数内容,设置输入法类型,并将参数指定类型设置为当前输入法类型,同时设置该类型对应的输入法环境参数输入法语言结构。包括输入法语种、输入法子语种、输入法类型返回值成功/失败6.4.3.5IMEResetlmeIME—ResetIme描述如下函数名IMEResetIme说明重设当前输入法的状态参数输入法语言结构。包括输入法语种、输入法子语种、输入法类型返回值成功/失败6.4.3.6IMEGetCurlme1MEGetCurIme描述如下函数名IMEGetCurIme说明获取当前输入法参数,并给参数赋值参数输入法语言设置。包括输入法语种、输入法子语种、输入法类型返回值成功/失败6.4.3.7IME—GetUpStringIME—GetUpString描述如下:函数名IME—GetUpString说明获取上行内容,包括按键处理后传出的候选结果、结果数量、当前上行的排列方式、高亮位置等参数将上行处理的候选结果、结果数量、排列方式等传人参数,并由参数返回返回值成功/失败6.4.3.8IME—GetDownStringIME—GetDownString描述如下函数名IME—GetDownString说明取下行内容,包括按键处理后传出的候选结果、结果数量、当前上行的排列方式、高亮位置等参数将下行处理的候选结果、结果数量、排列方式等传人参数,并由参数返回返回值成功/失败6.4.3一IME—SetFocusIME—SetFocus描述如下70 标准分享网www.bzfxw.com免费下载GB/T25654~2010函数名IMESetFocHs说明设置当前输入法的输入焦点参数设置的输入法的焦点位置。分为上行焦点、下行焦点返回值成功/失败6.4.3.10IMEGetCurFocu$IMEGetCurFocus描述如下函数名IMEGetCurFocus说明获取当前输入法的输入焦点参数无返回值返回当前输入法焦点6.4.3.11IMEGetWordAbsIME—GetWordAbs描述如下函数名IME—GetWordAbs说明按照要取出的字词在候选字符串中的绝对位置,取出字词,并将当前输入法置位参数a)绝对位置,输入法保存输出字符串的字符串数组的首地址b)保存在此位置上的字词的输出字符串返回值成功/失败6.4.3.12IMEGetWordRelIME—GetWordRel描述如下函数名IME—GetWordRel说明按照要取出的字词在候选字符串中的相对位置,取出字词,并将当前输入法置位参数a)相对位置,输入法保存输出字符串的字符串数组的首地址b)保存了在此位置上的字词的输出字符串返回值成功/失败7应用层7.1电话功能电话功能主要提供了具备电话功能的手持电子产品所具备的API。7.1.1电话功能系统模型电话功能主要完成处理呼叫,呼叫等待,呼叫挂起,多方通话,呼叫限制等功能。开机之后电话进入紧急呼叫状态,通过查询电话状态,在相应电话业务验证的情况下,进入呼叫等待状态。当发起一个呼叫后,电话进入呼叫中状态。当所有电话都被禁止的时候,进入呼叫关闭状态。呼叫等待状态下,当电话业务验证未通过的时候(例如,手机中的SIM卡发生异常),则由呼叫等待状态进入紧急呼叫状态。就手持移动电话所具备的基本功能而言,其中有如多方通话等扩展业务功能,要根据手持设备所对应的实际网络提供业务情况而决定。7.1.2电话业务7.1.2.1概述对手持设备的基本电话业务功能进行定义。71 GB/T25654—20107.1.2.2PHoNECaUPHONE—Call描述如下函数名PHoNECaU说明向指定的电话号码发起主动呼叫参数定义为电话号码字符串,最大长度定义为MAX—PHONENUM返回值NULL1.2.3PHONECallAnswerPHONE—CallAnswer描述如下函数名PHONECallAnswer说明作为被叫时,收到被叫信息时,通过调用这个函数,使得手机设备进入通过状态。在实现时,也可以通过激活语音通过通道参数无返回值a)接听失败b)接听成功7.1.2.4PHONE—CaUHmagPHONE—CallHung描述如下函数名PHONE—CallHung说明调用可以挂断所有线路上的通话参数无返回值a)挂断成功b)挂断失败7.1.2.5PHONECallHoldPHONE—CallHold描述如下函数名PHONE—CallHold说明a)用于呼叫保持、切换、激活不同的线路b)建立多方的电话会议参数说明保持、激活多路电话的方式:a)若有呼叫等待电话,则告诉等待状态的电话正忙;若没有呼叫等待,则将所有的处于保持状态的通话连接结束b)将当前所有正在进行的通话结束,从而接昕等待或保持状态的电话c)将所有激活的电话处于保持状态,而接受其他等待或保持状态的电话,可以在2个通话连接之间不断进行切换d)激活所有的保持状态的会话,进人多方会话e)将2个电话建立连接,自己退出f)用于结束某个正在进行的会话连接g)将所有激活的会话连接(除了x连接)置于保持状态,需要通信网络的支持72 标准分享网www.bzfxw.com免费下载GB/T25654—2010l返回值a)设置状态成功b)暂时不允许操作c)建立多方通话不成功,导致所有电话连接关闭7.1.2.6PHoNECCWAGetPHONE—CCWAGet描述如下函数名PHONE—CCWAGet说明查询呼叫等待业务的状态参数业务类型(语音、数据、传真等)返回值a)呼叫等待使能b)呼叫等待禁止c)没有回应,超时出错d)查询不到,很可能是由于网络连接不正常7.1.2.7PHONECCWASetPHONE—CCWASet描述如下函数名PHONE—CCWASet说明使能或禁止呼叫等待功能参数a)业务类型(语音、数据、传真等)b)模式参数。1为设置使能,0为设置禁止返回值a)设置成功b)没有回应,超时出错c)该操作不允许d)没有相应的网络服务e)设置不成功,很可能是由于网络连接不正常7.1.2.8PHONECLCKGetPHONE—CLCKGet描述如下函数名PHONE—CLCKGet说明查询指定类型的呼叫限制的状态参数a)PIN码b)禁拨全部电话c)禁拨国际电话d)除本国外禁拨e)禁接全部电话f)漫游时禁接g)PIN2码返回值a)相关类型的FAC被lockedb)相关类型的FAC没有lockedc)FAC类型错误,应用上基本不会产生d)没有回应,超时出错73 GB/T25654--20107.1.2.9PHONECLCKSetPHONE—CLCKSet描述如下函数名PHONE—CLCKSet说明对指定的限制类型进行相应的设置(加锁、解锁)参数a)参见PHONE—CLCKStatusb)0值为解锁,1值为加锁c)需要输入的密码字符串描述符返回值a)FAC类型错误,应用上基本不会产生b)没有回应,超时出错c)lock参数出错,设置为0、1之外的数,应用上基本不会产生d)设置成功e)该服务还没有注册7.1.2.10PHONECCFCGetPHONE—CCFCGet描述如下函数名PHONE—CCFCGet说明查询指定业务的呼叫转移的设置情况参数a)呼叫转移类型:0无条件转移l遇忙转移2无应答转移3无法接通转移b)呼叫类型(voice、data、fax等)c)需要解析得到的电话号码字符串描述符,不可为NULL,若没有设置呼叫转移,该值可以为NULLd)当呼叫转移类型为无应答转移时,该参数用于存放要解析出的具体延迟时间,单位为秒;若呼叫转移类型不为无应答转移,该值为0返回值a)该转移类型开启,并且可以得到电话号码,若类型为无应答转移,呼叫时间也能够得到b)该转移类型设置了,但没有使能,可以得到电话号码,若类型为无应答转移,呼叫时间也能够得到c)该转移类型没有进行设置,电话号码得不到,呼叫时间也得不到d)没有回应,超时出错;或者电话号码可以得到,但该地址为NULL的情况e)查询不到,很可能是由于网络连接不正常PHONE—CCFCSet描述如下l函数名PHONECCFCSetl说明对不同的业务设置不同的转移类型74 标准分享网www.bzfxw.com免费下载GB/T25654—2010参数a)呼叫转移类型参数:0无条件转移1遇忙转移2无应答转移3无法接通转移b)模式参数:0取消所有的转移1使能所有的转移2查询呼叫转移的状态3转移到指定的电话号码4取消指定类型的转移c)呼叫类型(voice、data、fax等)d)需要解析得到的电话号码字符串描述符,不可为NULI。,若没有设置呼叫转移,该值可以为NULLe)当呼叫转移类型参数为“无应答转移”时,这个参数用于存放要解析出的具体延迟时间,单位为秒;若呼叫转移类型参数不为“无应答转移”,该值可以为0返回值a)设置成功b)密码字符串为NULL的情况c)可能是由于网络连接不正常d)没有回应,超时出错e)该操作不允许,主要是在无条件转移已经开启的情况下,再继续设置其余3种呼叫转移类型7.1.3网络和运营商管理7.1.3..PHONE—NMInRegistPHONE—NMInRegist描述如下函数名PHONENMInRegist说明强制查找并注册网络参数无返回值注册成功/失败7.1.3.2PHoNENMGetoPListPHONE—NMGetOPList描述如下函数名PHONE—NMGet0PList说明获取当前能够搜索到的网络运营商列表参数运营商描述结构存储区域的描述符:a)运营商的编码,MCC+MNCb)运营商的名称返回值成功/失败 GB/T25654—20107.1.3.3PHONE—NMFreeOPListPHONE—NMFreeOPList描述如下函数名PHONE—NMFreeOPList说明调用PHONE—NMGetOPList成功获取运营商列表后,不再使用时使用本函数释放存储空间参数运营商描述结构存储区域的描述符返回值成功/失败7.1.3.4PHONE~NMGetCurOPPHONE—NMGetCurOP描述如下函数名PHONE—NMGetCur0P说明获取当前登录的网络运营商信息参数运营商描述结构存储区域的描述符:a)运营商的编码,MCC+MNCb)运营商的名称返回值成功/失败7.1.3.5PHONENMSeICurOPPHONE—NMSetCurOP描述如下:函数名PHONE—NMSetCurOP说明强制登录手动设置的运营商参数运营商描述结构存储区域的描述符:a)运营商的编码,MCC+MNCb)运营商的名称返回值成功/失败7.1.3.6PHONE—RSSIQueryPHONE—RSSIQuery描述如下函数名PHONE—RSSIQuery说明网络信号强度查询参数无返回值a)信号强度b)失败7.1.3.7PHONE—GetBearerStatePHONE—GetBearerState描述如下l函数名PHONE—GetBearerStatel说明返回指定承载网络的当前状态信息76 标准分享网www.bzfxw.com免费下载GB/T25654—2010l参数承载网络类型l返回值网络的状态7.1.4手机特殊管理7.1.4.1PHoNEModulelnitPHONE—ModuleInit描述如下函数名PHONE—ModuleInit说明a)初始化承载网协议栈b)检查SIM卡的状态c)检查PIN码和PUK码的状态d)搜索网络并注册e)设置来电显示f)设置短信的工作模式g)设置短信的提醒模式参数无返回值无7.1.4.2PHONEGetPinPukStatePHONE—GetPinPukState描述如下函数名PHONE—GetPinPukState说明查询SIM卡PIN码和PUK码的状态参数无返回值a)WAIT等待b)NOHSP不需校验开机密码c)NOPIN不需校验PIN码d)REQPIN需要PIN码校验e)REQPUK需要PUK码校验f)PINOKPIN码校验成功g)PUKOKPUK码成功7.1.4.3PHONE—IMEIQueryPHONE—IMEIQuery描述如下函数名PHONE—IMEIQuery说明获取手机的IMEI码参数指向存储IMEI码的存储空间的字符描述符返回值成功/失败7.1.4..PHONE—IMSIQueryPHONE—IMSIQuery描述如下77 甬数名P110NE1MSlQLicry说明获取手机的IMSI码参数指向存储IME[码的存储空间的字符描述符返旧值成日肤败72消息类功能721手持电子设备的消息模型消息部讣完成对SMS、MMS、EMAII的编解码、消息解析以及消息管理功能。消息部分可以分为3层网络接n层、消息解析层和统一消息管理层.冀结构如罔|l所示图4消息处理的层玟结构囝4中的网络接u层1j数据通讯层相接,负责应用的注册和信息的&进。消息解析层砸贵完成对信息的解析.给出信息类型.返回应用所需要的数据。统,消息管理层负责把消息放副适当文件史-h并以正确的方式显示。彩信文件的编解码方式是SMlI.邮件的编解码方式是MIME。722网络接口层功能721NetIntAppRegisterNctImAppRegister描述如下幽数名NetIntAppRegisteri兑明消息类应川『q数据层进行注册_——罄数a)消息娄应用的描述符b)消包类型.表叫是SMS、MMS、EMAII。c}t的一种返叫值成功,惜误码72NetIntAppUnRegisterNetIntAl】punRc91st¨描述如下函数名NetIntAPpUnReg⋯st说明消息类应井{H数据层进行注销参数a)消息类应用的描述符b)消息类刊,表明是SMS、MMS、EMAII,中的种返心值成功,错瀑』玛 标准分享网www.bzfxw.com免费下载7.2.2一NetIntSendMsgNetInt—SendMsg描述如下GB/T25654—2010函数名NetInt—SendMsg说明消息类应用向数据层发送信息参数a)消息类应用的描述符b)消息类型,表明是SMS、MMS、EMAII.中的一种c)要发送的信息长度d)要发送的信息内容描述符返回值成功/错误码7.2.2.4NetInt——ChangeModeNetIntChangeMode描述如下函数名NetInt—ChangeMode说明在只读方式和读写方式之间进行切换。如果已经有进程用读写方式打开消息应用,则失败参数a)消息类应用的描述符b)消息类型,表明是SMS、MMS、EMAIL中的一种c)读写方式,一般为只读或读写返回值成功/错误码7.2.3消息解析层功能7.2.3.1Msg_GetAddrMsg—GetAddr描述如下函数名Msg—GetAddr说明获得消息中的收发者主特征值。例如短消息,如果消息不在草稿或发件箱中,则地址是发送者的电话号码。如果在草稿或发件箱中,则是接收者的电话号码参数a)消息数据的描述符b)消息类型,表明是SMS、MMS、EMAIL中的一种c)存放数据的区域特征描述符d)存放数据的区域数据长度返回值成功/错误码7.2.3.2Msg—GetTimeMsgGetTime描述如下函数名Msg—GetTime说明获得所收到消息的日期和时间参数a)消息数据的描述符b)消息类型,表明是SMS、MMS、EMAIL中的一种c)存放日期的区域特征描述符d)存放时间的区域数据长度 GB/T25654—2010l返回值a)成功,返回日期、时间的数据结构的长度b)错误7.2.3.3MsgGetDataMsg—GetData描述如下函数名Msg_GetData说明获得所收到消息的数据。如果存放返回数据区的长度小于数据的实际长度则表示失败。还可以通过将数据区域描述符设置为NULL来调用,此时返回信息数据的实际长度参数a)消息数据的描述符b)消息类型,表明是SMS、MMS、EMAIL中的一种c)存放消息数据的区域特征描述符d)存放消息数据的区域长度返回值a)成功,返回日期、时间的数据结构的长度b)错误7.2.3.4Msg_GetDataLenMsg—GetDataLen描述如下函数名Msg—GetDataLen说明获得信息的数据的长度参数a)消息数据的描述符b)消息类型,表明是SMS、MMS、EMAIL中的一种返回值a)成功,返回信息数据的实际长度b)错误,返回错误码7.2.3.5Msg-GetstatlusMsg—GetStatus描述如下函数名Msg—GetStatus说明获得消息应用的状态参数a)消息数据的描述符b)消息类型,表明是SMS、MMS、EMAIL中的一种返回值成功/失败‘7.2.3.6Msg_GetListlnfoMsg—GetListlnfo描述如下l函数名Msg——GetListlnfol说明如果消息存在列表信息,可以获得指定消息的列表信息。包括发送者、标题、长度、状态等一80 标准分享网www.bzfxw.com免费下载GB/T25654—2010参数a)消息数据的描述符b)消息类型,表明是SMS、MMS、EMAIL中的一种c)存放列表信息数据的区域特征描述符d)存放列表信息数据的区域长度返回值成功/失败7.2.3.7Msg_ReadDataMsg—ReadData描述如下函数名Msg——ReadData说明读取消息数据,可以分多个片段读取。如果将存放数据区域描述符设置为NULL,返回数据的实际长度参数a)消息数据的描述符b)开始读取的位置c)存放读取的数据区域的特征描述符d)存放读取的数据区域的区域长度返回值成功/失败7.2.3.8SMSDecodeSMS—Decode描述如下函数名SMSDecode说明对收到的SMS-DELIVER型短消息进行解码。解出的数据结构存放到一个标识符指出的内存。内存的长度不得小于250个字节参数a)短消息原始数据存放区域的描述符b)短消息原始数据存放区域的长度c)解码后存放短消息数据区域的描述符d)解码后存放短消息数据区域的长度返回值a)成功,返回解码后存放短消息头部数据结构区域的描述符b)错误,返回NULL7.2.3.9SMSEneodeSMS_Encode描述如下函数名SMSEncode说明对短消息进行编码参数a)编码前存放原始数据的数据区域描述符b)存放编码后短消息的数据区域的描述符c)存放编码后短消息的数据区域的长度返回值a)成功,返回编码后存放短消息的数据区域的长度b)错误,返回0值7.2.3..0MMS—SMIL—DecodeMMSSMII。Decode描述如下81 GB/T25654—2010函数名MMS——SMIL——Decode说明对SMIL文件进行解码。解出的数据存放在一个指定的数据区域参数a)MMSSMIL文件原始数据的描述符b)MMSSMIL文件原始数据的长度c)存放解码后数据存储区域的描述符d)存放解码后数据存储区域的长度返回值成功/错误码7.2.3.11MMSSMILEncodeEncode描述如下函数名MMS——SMIL——Encode说明对Smil数据结构进行编码。编码后的数据放人指定的内存参数a)MMSSMIL文件原始数据的描述符b)MMSSMIL文件原始数据的长度c)存放编码后数据存储区域的描述符d)存放编码后数据存储区域的长度返回值成功/错误码7.2.4消息管理层功能7.2.4.1Msg..OpenMsg—Open描述如下函数名Msg—Open说明建立与消息引擎的连接,返回该连接数据结构存储区域的描述符。系统中只能有一个应用采用“读写方式”连接消息引擎。如果消息引擎已经被一个应用以“读写方式”连接,第二个以“读写方式”连接消息引擎的函数调用将失败参数a)消息引擎的描述符b)开始的位置c)接收消息的数据存储区域的描述符d)接收消息的数据存储区域的长度e)连接消息引擎的方式,只读还是读写f)信息的类型,SMS、MMS、EMAIL返回值a)成功,返回一个消息引擎描述符b)错误,返回NULL7.2.4.2Msg_ListFolderMsgListFolder描述如下【名称MsgListF。lderl说明获得一个文件夹的名字和属性。使用一个索引编号从0逐渐增加的方式反复调用,l获得所有的文件夹的信息82 标准分享网www.bzfxw.com免费下载GB/T25654—2010参数a)消息引擎的描述符。b)顺序索引编号,从0开始c)存放文件夹名字和属性的存储区域的描述符d)存放文件夹名字和属性的存储区域的长度e)信息的类型:MMS、SMS、EMAIL返回值成功/失败7.2.4.3MsgGetFolderlnfoMsg—GetFolderln{o描述如下函数名Msg—GetFolderlnfo说明获得一个文件夹的状态信息。例如共有多少条信息,占用多少存储耋间等参数a)消息引擎的描述符b)文件夹的名字c)存放文件夹信息的存储区域的描述符d)存放文件夹信息的存储区域的长度返回值成功/失败7.2.4.4Msg_CreateFolderMsgCreateFolder描述如下函数名Msg—CreateFolder说明创建一个文件夹参数a)消息引擎的描述符b)文件夹的名字返回值成功/失败7.2.4.5Msg_RemoveFolderMsg—RemoveFolder描述如下函数名Msg—RemoveFolder说明删除一个文件夹参数a)消息引擎的描述符b)文件夹的名字c)当文件夹不空时是否强制删除返回值成功/失败7.2.4.6Msg_ClearFolderMsg—ClearFolder描述如下函数名Msg—ClearFolder说明清空指定的文件夹参数a)消息引擎的描述符b)文件夹的名字返回值成功/失败83 GB/T25654—20107.2.4.7Msg_SelectFoiderMsg—SelectFolder描述如下函数名Msg—SelectFolder说明设置当前工作的文件夹参数a)消息引擎的描述符b)文件夹的名字返回值成功/错误7.2.4.8MsgListMsg—List描述如下函数名Msg—I,ist说明请求获得从某一索引号开始起的多条消息的列表信息。包括消息条数、发送者、长度、状态等参数a)消息引擎的描述符b)开始起索引号c)接受信息的存储区域的描述符d)请求接收的消息条数返回值成功/失败7.2.4.9Msg_MoveMsg—Move描述如下函数名Msg_Move说明将指定的信息从当前选择的文件夹移动到参数指定的文件夹中。是否能执行移动要看源文件夹和目的文件夹的关系:a)源文件夹必须与目的文件夹不同b)目的文件夹不能是收件箱和发件箱c)源文件夹不能是发件箱参数a)消息引擎的描述符b)消息的ID号c)目标文件夹的名字d)信息的类型:MMS、SMS、EMAIL返回值a)成功,该消息在新位置的ID号b)失败7.2.4.10Msg_CopyMsg—Copy描述如下函数名Msg—Copy说明将指定的信息从当前选择的文件夹复制到参数指定的目标文件夹中。是否能执行复制要看源文件夹和目的文件夹的关系:a)源文件夹必须与目的文件夹不同b)目的文件夹不能是收件箱和发件箱 标准分享网www.bzfxw.com免费下载GB/T25654—2010参数a)消息引擎的描述符b)消息的ID号。c)目标文件夹的名字d)信息的类型:MMS、SMS、EMAIL返回值a)成功,新复制的消息的ID号b)失败,0值7.2.4.11Msg_SaveMsg—Save描述如下函数名Msg—Save说明将正在编辑的信息保存在草稿文件夹中,不能保存到其他任何文件夹中参数a)消息引擎读写控制结构的描述符b)要保存的消息数据的描述符c)要保存的消息数据的长度d)消息接收者的电话号码,可以是多个发送地址e)信息的类型:MMS、SMS、EMAIL返回值a)成功,返回保存的短消息的ID号b)失败7.2.4.12Msg_DeleteMsg—Delete描述如下函数名Msg—Delete说明请求从当前选择的文件夹中删除参数所标记的一条消息参数a)消息引擎的描述符b)消息的ID号c)信息的类型,MMS、SMS、EMAIL返回值成功/失败2.4.13MAILConnectMAIL~Connect描述如下函数名MAIL_Connect说明开始与邮件服务器连接参数邮件引擎的描述符返回值成功连接/未成功连接7.2.4.14MAILDiseonnectMAIL—Disconnect描述如下l函数名MAIL—DisconnectI说明断开与邮件服务器连接。如果当时正在接收邮件,则取消该邮件的接收;如果当时在执行其他函数,则等函数完成后再执行断开连接 GB/T25654—2010I参数邮件引擎的描述符l返回值无7.3桌面系统7.3.1概述桌面系统为一个可以对桌面显示进行修改处理的模块,它包括2个部分:一个是控制面板,另一部分是PIM。PIM部分包括了对个人信息的增加、删除、修改。个人信息包含地址簿、日程表等,每一种类型的数据为一种表格,数据以记录的形式分条存放。控制面板包括对桌面显示布局的修改,包括对墙纸,桌面风格的修改,所有的应用都可以通过控制面板在桌面系统上创建和修改图标。7.3.2个人信息接口API7.3.2.1PIMAddPIMAdd描述如下函数名PIMAdd说明在数据库的最末增加一条记录参数指向个人信息数据结构的结构描述符返回值成功/失败7.3.2.2PIMInsertPIM—Insert描述如下函数名PIMInsert说明在数据库指定位置插入一条记录参数a)指向个人信息数据结构的结构描述符b)插入记录至数据库表格的位置返回值成功/失败7.3.2.3PIMGetstatUSPIM—GetStatus描述如下函数名PIMGetStatus说明获得PIM数据库的状态,包括当前的记录数、文件的长度、无效记录数等参数a)指向个人信息数据结构的结构描述符b)获得状态数据区的描述符返回值成功/失败7.3.2.4PIM—SavePIMSave描述如下函数名PIMSave说明将PIM数据库当前的修改保存到文件中参数指向个人信息数据结构的结构描述符返回值成功/失败 标准分享网www.bzfxw.com免费下载7.3.2.5PIM—SortPIM—Sort描述如下GB/T25654—2010函数名PIMSort说明对指定类型的数据进行排序参数a)指向个人信息数据结构的结构描述符b)排序字段的名称c)排序的方式(升序、降序、按内码、按拼音等)返回值成功/失败7.3.2一PIM—FindPIM—Find描述如下函数名PIMFind说明返回排序字段的数值等于指定数值的第一个记录参数a)指向个人信息数据结构的结构描述符b)指向排序字段的数值的描述符c)排序字段数值的长度d)记录开始查找的位置e)总共查找的记录数返回值查找到记录的索引值7.3.2.7PIM—DeletePIM—Delete描述如下函数名PIMDelete说明删除当前记录参数指向个人信息数据结构的结构描述符返回值成功/失败7.3.3控制面板接口API7.3.3.1ControlParielInitControlPanel—Init描述如下函数名ControlPanel—Init说明控制面板初始化参数无返回值a)成功b)失败C)超时d)异常7.3.3.2ControlPanel——ChangeSkinControlPanelChangeSkin描述如下 GB/T25654—2010函数名ControlPanel—ChangeSkin说明改变桌面的墙纸或者桌面风格参数指向控制面板结构的结构描述符,表示新的SKIN值,包括墙纸和桌面风格返回值a)成功b)失败c)超时d)异常7.3.3.3ControlPanelGetInfoControlPanel—Getlnfo描述如下函数名ControlPanel—Getlnfo说明查询控制面板信息参数指向控制面板结构的结构描述符,表示当前的SKIN值返回值a)成功b)失败c)超时d)异常7.3.3.4ControlPanel—CreatAppIconControlPanel—CreatAppIcon描述如下函数名ControlPanel——CreatAppIcon说明在桌面上创建应用程序图标参数a)指向相关应用程序的描述符b)指向图标图片的描述符返回值a)成功b)失败c)超时d)异常7.3.3.5ControlPanel—DeleteApplconControlPanel—DeleteAppIcon描述如下函数名ControlPanel—DeleteApplcon说明删除桌面上的应用程序图标参数指向图标图片的描述符返回值a)成功,返回实际读取到的记录数b)失败c)超时d)异常7.3.3一ControlPanel—SetDateTimeControlPanel—SetDateTime描述如下88 标准分享网www.bzfxw.com免费下载GB/T25654—2010函数名ControlPanel—SetDateTime说明设置桌面系统的时间和日期参数a)日期b)时间返回值a)成功b)失败c)超时d)异常7.3.3.7ControlPanelActiveProfileControlPanel—ActiveProfile描述如下函数名ControlPanel—ActiveProfile说明激活某一情景模式作为当前的配置,如静音、会议、正常、户外等模式参数将被激活的情景模式状态返回值a)成功b)失败c)超时d)异常7.3.3.8ControlPanelGetProfileControlPanel—GetProfile描述如下函数名ControlPanel—GetProfile说明获取指定的情景模式的配置参数a)指定的情景模式b)指向情景模式配置结构的结构描述符返回值a)成功b)失败c)超时d)异常7.3.3.9ControlPanelSetProfileControlPanel—SetProfile描述如下函数名ControlPanel—SetProfile说明设置某一情景模式参数a)将被设置的情景模式b)指向情景模式配置结构的结构描述符返回值a)成功b)失败c)超时d)异常89 GB/T25654—20107.3.3.10ControlPanelGetNetProfileControlPanel—GetNetProfile描述如下函数名ControlPanelGetNetProfi[e说明获得当前网络的设置参数指向网络配置结构的结构描述符返回值成功/失败7.3.3.11ControlPanelSetNetProfileControlPanel—SetNetProfile描述如下函数名ControlPanel—SetNetProfile说明设置当前网络参数参数指向网络配置结构的结构描述符返回值成功/失败7.4Internet编程接口7.4.1综述Internet编程接口模型分为3层:解析层、表示层、应用层。在该模型中,底层的模块既是上层的支撑模块,又可以开放出来供应用直接调用。其中,解析层完成对WML、HTML、XHTMI,文档的解析;表示层实现浏览器网页请求、布局、交互、导航等功能;应用层统一封装了WML、HTML、XHTMI,这3种文档类型,允许应用创建自己的浏览器对象。7.4.2HTML/XHTML/wML浏览器应用层接口此应用层接口与底层浏览器承载无关,可以是上述任意一种浏览器或混合型浏览器,或者同时兼容HTML/XHTML/WML的浏览器。浏览器程序对外接VI包括两个部分:浏览器的操作命令和浏览器的消息。系统允许多个应用程序同时使用浏览器,每一个应用程序提供自己的消息传送接VI,创建自己的浏览器对象。7.4.2.1浏览器接口函数7.4.2.1.1BrowserCreateBrowser_Create描述如下函数名BrowserCreate说明创建一个浏览器对象。浏览器对象的窗口在指定的父窗口中创建,具有指定的位置和大小参数a)浏览器窗口的父窗口的描述符b)浏览器窗口左上角在父窗口中的位置z坐标值c)浏览器窗口左上角在父窗口中的位置Y坐标值d)浏览器窗口的宽度e)浏览器窗口的高度返回值a)浏览器的描述符b)失败 标准分享网www.bzfxw.com免费下载7.4.2.1-2Browser—DestroyBrowser—Destroy描述如下GB/T25654—2010函数名Browser—Destroy说明删除一个浏览器对象参数浏览器对象返回值无7.4.2.1_3BrowserNavigateBrowserNavigate描述如下函数名Browser—Navigate说明使浏览器开始浏览一个指定的页面参数a)浏览器对象的描述符b)希望浏览的页面的URL字符串的描述符c)用POST方式发送请求时的POST数据。如果该参数为NUI。L,表示用GET方式获得页面。如果该页面不是一个HTTP协议的URL,该参数被忽略d)希望附加发送的HTTP请求头的描述符。该附加的请求头被附带在HTTP标准请求头的后面发送返回值成功/失败7.4.2.1.4BrowserRefreshBrowser—Refresh描述如下函数名Browser—Refresh说明使浏览器对象刷新当前显示的页面参数浏览器对象的描述符返回值成功/失败7.4.2.1.SBrowser_StopBrowser—Stop描述如下函数名BrowserStop说明使浏览器对象停止对所有尚未传输完的对象的传输操作,也停止声音播放和动画GIF的动作,以及停止JavaScript的执行参数浏览器对象的描述符返回值成功/失败7.4.2.1.6BrowserGoBackBrowser—GoBack描述如下函数名BrowserGoBack说明使浏览器对象显示浏览历史的前一个页面参数浏览器对象的描述符返回值成功/失败91 GB/T25654—20107.4.2.1.7BrowserGoForwardBrowser—GoForward描述如下函数名Browser—GoForward,说明使浏览器对象显示浏览历史的下一个页面参数浏览器对象的描述符返回值成功/失败7.4.2.1.8Browser_SetLayoutWidthBrowserSetLayoutWidth描述如下函数名Browser—SetLayoutWidth说明设置浏览器排版时使用的参考宽度。如果该值设置为非0,则无论浏览器窗口的宽度怎样变化,浏览器始终以该参考宽度进行排版。如果该值设置为0,则浏览器以当前的窗LI宽度为参考宽度进行排版,窗口宽度改变时浏览器将自动重新排版参数a)浏览器对象的描述符b)要设置的宽度的数值返回值无7.4.2.1.9Browser_SetCharSetBrowser—SetCharSet描述如下函数名Browser—SetCharSet说明设置浏览器使用的缺省字符集参数a)浏览器对象的描述符b)要设置的字符集的代码返回值无7.4.2.1.10BrowserSetFontModeBrowser—SetFontMode描述如下函数名Browser—SetFontMode说明设置浏览器的基本字体的大小参数a)浏览器对象的描述符b)字体大小返回值无7.4.2.1.11Browser_SetImageModeBrowserSetImageMode描述如下函数名Browser—SetImageMode说明设置浏览器是否显示图形参数a)浏览器对象的描述符b)显示模式,显示图形或不显示图形返回值无92 标准分享网www.bzfxw.com免费下载7.4.2.1.12Browser_SetIOModeBrowserSetIOModeGB/T25654—2010函数名BrowserSetIOMode说明设置浏览器工作模式参数a)浏览器对象的描述符b)端口模式,file、http、wapstack返回值无7.4.2.1.13Browser_IsBusyBrowser—IsBusy描述如下函数名BrowserlsBusy说明测试浏览器对象是否处于空闲状态。浏览器处于空闲状态是指浏览器尚未开始传送URI。对象或者浏览器对象需要的所有URL对象都接收完毕参数浏览器对象的描述符返回值a)非空闲状态b)空闲状态7.4.2.1.14BrowserGetCurrentURLBrowserGetCurrentURL描述如下函数名Browser—GetCurrentURL说明获得浏览器对象当前活动页的URL名字字符串。由于HTML页面有转接等功能,最后显示的URL可能并不是Navigate命令给出的URL参数浏览器对象的描述符返回值URL名字字符串7.4.2.1.15Browser_GetWindowHandleBrowser_G-etWindowHandle描述如下函数名Browser—GetWindowHandle说明获得浏览器对象使用的显示窗口的描述符,使用浏览器的程序获得该描述符后可以对浏览器窗口进行移动、改变大小等操作参数浏览器对象的描述符返回值浏览器对象显示窗口的描述符7.4.2.1.16Browser_GetLayoutWidthBrowserGetLayoutWidth描述如下函数名Browser_GetLayoutWidth说明获取浏览器排版宽度参数浏览器对象的描述符返回值当前排版时使用的参考宽度93 GB/T25654—20107.4.2.1.17BrowserGetCharSetBrowser—GetCharSet描述如下函数名Browser—GetCharSet说明获取浏览器当前使用的字符集参数浏览器对象的描述符返回值当前浏览器使用的缺省字符集7.4.2.1.18Browser_GetFontModeBrowserGetFontMode描述如下函数名Browser—GetFontMode说明获取浏览器当前的字体大小参数a)浏览器对象的描述符b)字体模式返回值浏览器当前使用的基本字体的大小7.4.2.1.19Browser_GetImageModeBrowserGetlmageMode描述如下函数名Browser—GetlmageMode说明获取浏览器当前使用的显示图形控制方式参数浏览器对象的描述符返回值浏览器当前使用的显示图形控制方式7.4.2.1.20Browser_GetStatuslnfoBrowserGetStatusIn{o描述如下函数名Browser—GetStatusInfo说明获取浏览器状态信息参数浏览器对象的描述符返回值浏览器状态信息描述符7.4.2.1.21Browser_GetTitleBrowser—GetTitle描述如下函数名BrowserGetTitle说明获取浏览器当前网页标题信息参数浏览器对象的描述符返回值浏览器标题信息描述符7.4.2.1.22Browser_SaveToHtmlBrowser—SaveToHtml描述如下94 标准分享网www.bzfxw.com免费下载GB/T25654—2010函数名Browser—SaveToHtml说明保存当前网页为html文件格式参数a)浏览器对象的描述符b)文件名返回值成功/失败7.4.2.1.23BrowserSaveToTextBrowser—SaveToText描述如下函数名Browser—SaveToText说明保存当前网页为txt文件格式参数a)浏览器对象的描述符b)文件名返回值成功/失败7.4.2.1.24BrowserSearchBrowser—Search描述如下函数名BrowserSearch说明从当前位置开始,在当前网页搜索指定的字符串,并定位到找到的第一个字符串位置参数a)浏览器对象的描述符b)要查找的字符串返回值a)未找到b)找到7.4.2.2浏览器的消息7.4.2.2.1Browser_BeforeNavigateBrowserBeforeNavigate描述如下函数名Browser—BeforeNavigate说明当浏览器开始浏览一个页面之前,向该浏览器的消息发送窗El发送该消息参数a)接收消息的对象的描述符b)发送该消息的浏览器对象的描述符c)目标URL字符串的描述符d)用Post方式发送的数据的描述符,为NULL表示用Get方式e)附加的HTTP请求头数据的描述符返回值成功/失败7.4.2.2.2Browser_ProgressChangeBrowser—Progresscha“ge描述如下I函数名Browser—ProgressChangel说明当浏览器接收到新的数据时向该浏览器的消息发送窗El发送该消息 GB/T25654—2010参数a)接收消息的对象的描述符b)发送该消息的浏览器对象的描述符c)URL字符串的描述符d)表示当前进度的整数e)表示当页面操作完成时的进度数值的整数返回值无7.4.2.2.3Browser_DownloadBeginBrowser—DownloadBegin描述如下函数名Browser_DownloadBegin说明当浏览器开始下载一个连接对象时向该浏览器的消息发送窗口发送该消息参数a)接收消息的对象的描述符b)发送该消息的浏览器对象的描述符c)URL字符串的描述符返回值无7.4.2.2.4Browser_DownloadCompleteBrowser—DownloadComplete描述如下函数名Browser_DownloadComplete说明当浏览器下载完毕一个连接对象时向该浏览器的消息发送窗口发送该消息参数a)接收消息的对象的描述符b)发送该消息的浏览器对象的描述符c)URL字符串的描述符返回值无7.4.2.2.5’Browser_ReDisplayBrowser—ReDisplay描述如下函数名Browser—ReDisplay说明当浏览器可显示内容发生变化,向该浏览器的消息发送窗口发送该消息参数a)接收消息的对象的描述符b)发送该消息的浏览器对象的描述符返回值无7.4.2.2.6Browser_StatusChangeBrowser—StatusChange描述如下函数名Browser—StatusChange说明当浏览器状态信息发生改变,向该浏览器的消息发送窗口发送该消息参数接收消息的对象的描述符发送该消息的浏览器对象的描述符返回值无96 标准分享网www.bzfxw.com免费下载GB/T25654—20107.4.3HTML/xHTML/wML浏览器表示层接口7.4.3.1概述Browser表示层为应用层所调用,实现浏览器网页请求、显示、交互、导航等诸功能。7.4.3.2系统与配置类7.4.3.2.1BrowserInitCtxtBrowser—InitCtxt描述如下函数名Browser—InitCtxt说明初始化一个浏览器实例参数初始化浏览器结构描述符返回值浏览器描述符7.4.3.2.2Browser_CloseCtxtBrowser—CloseCtxt描述如下函数名Browser—CloseCtxt说明卸载一个浏览器实例参数浏览器描述符返回值无7.4.3.2.3Browser_SetWidthBrowser—SetWidth描述如下函数名Browser—SetWidth说明设置浏览器布局宽度参数a)浏览器描述符b)宽度返回值无7.4.3.2.4Browser_GetWidthBrowser—GetWidth描述如下函数名Browser—GetWidth说明获取浏览器布局宽度参数浏览器描述符返回值浏览器布局宽度7.4.3.2.5Browser—SetNativeCharsetBrowser—SetNativeCharset描述如下函数名Browser—SetNativeCharset说明设置缺省本地字符集参数a)浏览器描述符b)字符集代码返回值无97 GB/T25654—20107.4.3.2.6BrowserGetNativeCharsetBrowser—GetNativeCharset描述如下函数名Browser—Ge*_NativeCharset说明获取缺省本地字符集参数浏览器描述符返回值本地字符集代码7.4.3.2.7BrowserSetCurrentCharsetBrowser—SetCurrentCharset描述如下函数名Browser—SetCurrentCharset说明设置当前网页的字符集代码参数a)浏览器描述符b)字符集代码返回值无7.4.3.2.8BrowserGetCurrentCharsetBrowserGetCurrentCharset描述如下函数名Browser—GetCurrentCharset说明获取当前页面字符集代码参数浏览器描述符返回值字符集代码7.4.3.2.9BrowserSetWidthFuncBrowser—SetWidthFunc描述如下函数名Browser—SetWidthFunc说明设置字符宽度计算的回调函数,具体参数可自定义参数a)浏览器描述符b)函数描述符返回值无7.4.3.2.10Browser_SetHeightFuncBrowser—SetHeightFunc描述如下函数名Browser—SetHeightFunc说明设置字符高度计算的回调函数参数a)浏览器描述符.b)函数描述符返回值无7.4.3.2.11Browser_SetHttpProxyBrowser—SetHttpProxy描述如下98 标准分享网www.bzfxw.com免费下载GB/T25654—2010函数名Browser—SetHttpProxy说明设置http参数参数a)浏览器描述符b)http代理服务器地址c)http代理服务器端口d)用户名e)口令返回值无7.4.3.2..2Browser—SetWapProxyBrowser—SetWapProxy描述如下函数名Browser—SetWapProxy说明设置wap协议栈参数参数a)浏览器描述符b)Wap网关地址c)Wap网关端口返回值无7.4.3.2..3Browser—SetlmgModeBrowser~SetfmgMode描述如下函数名Browser—SetlmgMode说明设置是否支持图片参数a)浏览器描述符b)图片支持模式:支持,不支持‘·返回值无7.4.3.2.14BrowserSetNetModeBrowser~SetNetMode描述如下函数名BrowserSetNetMode说明设置使用的承载网类型参数a)浏览器描述符b)承载网类型:file,http,wapstaek返回值无7.4.3.3网页显示类7.4.3.3..Browser—SumPagesBrowser~SumPages描述如下I函数名Browser—SumPagesl说明当前浏览器实例的页面数目 GB/T25654—2010I参数浏览器描述符I返回值页面数目7.4.3.3.2Browser_NeedReDisplayBrowser—NeedReDisplay描述如下函数名Browser—NeedReDisplay说明当前网页在可显示范围内容是否发生变化,若发生变化,需要更新显示参数a)浏览器描述符b)当前显示区域的上边界c)当前显示区域的下边界返回值a)需要刷新b)不需要刷新7.4.3.3.3Browser_GetPageHeightBrowserGetPageHeight描述如下函数名Browser—GetPageHeight说明获取当前页面的逻辑高度,用于设置滚动条高度参数浏览器描述符返回值页面高度7.4.3.3.4BrowserGetMemSizeBrowser—GetMemSize描述如下函数名Browser—GetMemSize说明获取当前页面需要的内存大小参数浏览器描述符返回值当前页面需要的内存大小7.4.3.3.5BrowserGetStatuslnfoBrowser—GetStatusInfo描述如下函数名Browser—GetStatusInfo说明获取浏览器状态信息参数浏览器描述符返回值浏览器状态信息描述符7.4.3.3.6Browser_GetFirstNodeByYposBrowser—GetFirstNodeByYpos描述如下l函数名Browser—GetFirstNodeByYposl说明获取逻辑坐标大于Y的第一个元素的序号100 标准分享网www.bzfxw.com免费下载GB/T25654—2010l参数a)浏览器描述符b)坐标l返回值元素的序号7.4.3.3.7Browser_GetNodelnfoBrowser—GetNodelnfo描述如下函数名Browser—GetNodeInfo说明通过元素序号获取元素信息参数a)浏览器描述符b)元素序号c)元素结构描述符返回值下一个元素的序号,0则结束7.4.3.3.8Browser_GetBaseBrowser—GetBase描述如下函数名Browser—GetBase说明获取基准地址参数浏览器描述符返回值基准地址‘7.4.3.3.9Browser_URLResolveBrowser—URLResolve描述如下函数名Browser—URLResolve说明计算绝对地址参数a)基准地址b)相对地址返回值绝对地址7.4.3.4交互处理类7.4.3.4.1Browser_ResetFormBrowser—ResetForm描述如下函数名Browser_ResetForm说明重置(恢复)表单数据参数a)浏览器描述符b)当前网页要重置的表单的序号返回值无7.4.3.4.2Browser_SubmitFormBrowser—SubmitForm描述如下101 GB/T25654—2010函数名BrowserSubmitForm说明提交表单数据参数a)浏览器描述符b)提交按钮的序号返回值成功返回提交的网址,失败返回07.4.3.4.3Browser_SetSingleSelectIndexBrowsersetsingIeselectIndex描述如下函数名Browser—SetSingleSelectIndex说明当用户改变一个单选列表的选项时调用该接口参数a)浏览器描述符b)下拉列表元素的序号c)选中的列表中第几个元素返回值无7.4.3.4.4BrowserSetRadioSelectedBrowser—SetRadioSeleeted描述如下函数名Browser—SetRadioSelected说明当用户选择一个radio按钮时调用该接IZl,将会清除同组中其他radio按钮的选中状态参数a)浏览器描述符b)Radio按钮的序号返回值无7.4.3.4.5BrowserSetValueBrowser—SetValue描述如下函数名BrowserSetValue说明设置form元素的值(单选列表和radio因有专用函数不使用该接E1)参数a)浏览器描述符b)form元素序号c)值的类型d)设置值返回值成功/失败7.4.3.4.6Browser_GetAByNameBrowser—GetAByName描述如下l函数名Browser——GetAByNameI说明根据A元素的名字获取序号,用于页内跳转102 标准分享网www.bzfxw.com免费下载GB/T25654—2010参数a)浏览器描述符b)A元素的名字返回值a)A元素的序号b)失败7.4.3.4.7BrowserAClickedBrowser—AClicked描述如下函数名BrowserAClicked说明设置热连接为访问过状态参数a)浏览器描述符b)A元素的序号返回值无7.4.3.5导航类7.4.3.5.1Browser_NavigatorBrowser—Navigator描述如下函数名BrowserNavigator说明启动网页下载参数a)浏览器描述符b)指向希望浏览的页面的uRI。字符串的描述符c)指向用POST方式发送请求时的POST数据。如果该参数为NULL,表示用GET方式获{导页面。如果该更面不是一个HTTP协议的URI.,该参数被忽略d)指向希望附加发送的HTTP请求头的描述符。该附加的请求头被附带在HTTP标准请求头的后面发送返回值成功/失败7.4.3.5.2BrowserPostNavigatorBrowser—PostNavigator描述如下函数名Browser—PostNavigator说明将网页请求放在队列中,系统空闲时执行参数a)浏览器描述符b)希望浏览的页面的URI.字符串的描述符c)用POST方式发送请求时的POST数据。如果该参数为NULL,表示用GET方式获得页面。如果该页面不是一个HTTP协议的URI,,该参数被忽略d)希望附加发送的HTTP请求头的描述符。该附加的请求头被附带在HTTP标准请求头的后面发送返回值成功/失败7.4.3.5一BrowserNaviForwardBrowser—NaviForward描述如下103 GB/T25654—2010函数名Browser—NaviForward说明切换当前页面到下一个页面参数浏览器描述符返回值下一个页面的地址7.4.3.5.4BrowserNaviBaekBrowser—NaviBack描述如下函数名Browser——NaviBack说明切换当前页面到上一个页面参数浏览器描述符返回值上一个页面的地址7.4.3.5.5Browser_NaviStopBrowser—NaviStop描述如下函数名Browser—NaviStop说明停止页面或资源下载参数浏览器描述符返回值成功/失败7.4.3.5.6BrowserRefreshBrowser_Refresh描述如下函数名Browser—Refresh说明刷新当前页面参数浏览器描述符返回值成功/失败7.4.3.5.7Browser_NaviRedirectBrowser—NaviRedireet描述如下函数名Browser—NaviRedirect说明处理自动跳转到新页面,每秒调用一次参数浏览器描述符返回值a)新页面地址b)失败7.4.3.5.8Browser_GetPageHeightBrowser—GetPageHeight描述如下I函数名Browser—GetPageHeightl说明获取当前页面高度,用于显示和控制滚动条104 标准分享网www.bzfxw.com免费下载GB/T25654—2010I参数浏览器描述符l返回值页面高度、7.4.3.5.9BrowserGetYPosBrowser—GetYPos描述如下函数名Browser—GetYPos说明获取当前页面滚动Y坐标位置,用于前进后退时恢复到上次访问的位置参数浏览器描述符返回值Y坐标位置7.4.3.5.10BrowserSetYPosBrowser—SetYPos描述如下函数名BrowserSetYPos说明设置当前页面滚动_坐标位置,用于前进后退时恢复到上次访问的位置参数a)浏览器描述符b)y坐标位置返回值y坐标位置7.4.3.6Javascript调用接口7.4.3.6.1Browser_ExecHrefCodeBrowser—ExeeHrefCode描述如下函数名Browser—ExeeHrefCode说明执行热连接href属性中的javascript参数a)浏览器描述符b)热连接元素序号返回值a)执行缺省热连接动作b)不执行7.4.3.6.2Browser_ExecScriptBrowser—ExeeSeript描述如下函数名Browser—ExecSeript说明执行一段javascript参数a)浏览器描述符b)Javascript字符串返回值成功/失败7.4.4HTML/XHTML/WML浏览器解析层接口7.4.4.1Browser_ParserXMLBrowserParserXML描述如下:105 742BrowserDestroyDocBrowserDestroyDoc描述如下甬数名说叫释放Dom结构参数DOM模型结构描述符返吲值无5多媒体51系统模型本条规定r于持电子产品与多媒体相关的软件所需要使用的AI,I。一方面定义r基本编解码器的装载过程,能够加载不阿的编解码模块埘图片、音频、视频等进行处理,另一个方面定义r于持电子产品进行多媒体相关操作时需要用到的功能.主要包括媒体播放、录音、摄像和FTS等。多媒体API的系统模型由两个屡次构成,如图5所示:图5多媒体API的系统模型基础层由基础编码器和解码器构成,支持常见媒体格式的编解码.如图H(BMP、PNG、GIF、JPEG等格式),音频(AMR、MIDI、MP3等格式),视频(AVS、H263、MPEG4等编解码方式)。埴蝠层根据电子手持世备的常用功能,设置了1组应用级API媒体播放器、录音器、摄像机和TTS。媒体播放器提供媒休播放的控制接n录音器提供音频输入控制接口.摄像机提供摄像输^控制接u,TTS提供文本的语音合成接口。52基础编解码器APl521EncoderCreateEncoderCreale捕述如f函数名说明创建一个编码器.生成设备描述符参数创建的编码器娄型返ld值成功,失啦 标准分享网www.bzfxw.com免费下载7.5.2.2EncoderEncodeEncoder—Encode描述如下GB/T25654--2010函数名Encoder—Encode说明应用已经创建的编码器,对媒体进行编码参数a)编码器设备描述符b)一编码参数返回值成功/失败7.5.2.3Encoder_DestroyEncoderDestroy描述如下函数名Encoder——Destroy说明释放编码器资源,销毁编码器参数编码器的设备描述符返回值无7.5.2.4DecoderCreateDecoder—Create描述如下函数名DecoderCreate说明创建一个解码器参数解码数据类型返回值成功/失败7.5.2.5DecoderDecodeDecoderDecode描述如下函数名Decoder—Decode说明进行解码参数a)解码器设备描述符b)解码参数返回值成功/失败7.5.2.6Decoder—DestroyDecoder—Destroy描述如下函数名Decoder—Destroy说明释放解码器资源,销毁解码器参数解码器的设备描述符返回值无7.5.3TTS接口API7.5.3.1TTSCreateTTSCreate描述如下107 GB/T25654—2010函数名TTSCreate说明对TTS初始化,加载所需的资源,完成初始化参数无返回值成功/失败7.5.3.2TTSDestroyTTSDestroy描述如下函数名TTSDestroy说明释放TTS资源,销毁TTs参数无返回值无TTSSpeak描述如下函数名TTSSpeak说明对文本进行语音合成并播放参数需要播放的文本返回值成功/失败7.5.3.4TTSPauseTTSPause描述如下函数名TTSPause说明暂停文本的语音合成和播放参数无返回值无7.5.3.5TTSResumeTTSResume描述如下函数名TTSResume说明已经被暂停的语音合成和播放的文本继续播放参数无返回值无7.5.3.6TTSStopTTSStop描述如下函数名TTSStop说明停止文本的语音合成和播放功能参数无返回值无108 标准分享网www.bzfxw.com免费下载7.5.3.7TTSGetStatusTTSGetStatus描述如下GB/T25654—2010函数名TTSGetStatus说明查询TTS的当前状态,并返回参数无返回值TTs当前的状态值7.5.3.8TTSSetParamTTSSetParam描述如下函数名TTSSetParam说明设置TTs的合成参数参数a)参数类型(语速、音量、音调、编码方式、念发习惯⋯⋯)b)以上参数类型的相应参数值返回值无7.5.3.9TTSGetParamTTSGetParam描述如下函数名TTSGetParam说明返回TTS的合成参数到一个数据结构中参数a)参数类型(语速、音量、音调、编码方式、念发习惯⋯⋯)b)以上参数类型的相应参数值返回值无7.5.4媒体播放器API7.5.4.1MediaCreateMedia—Create描述如下函数名MediaCreate说明创建媒体播放器,得到播放器设备描述符参数需要播放的媒体类型返回值创建成功/失败7.5.4.2Media—DestroyMediaDestroy描述如下函数名MediaDestroy说明销毁媒体播放器设备描述符,释放资源参数媒体播放器设备描述符返回值销毁成功/失败7.5.4.3Media——FastForwardMedia—FastForward描述如下109 GB/T25654—2010函数名Media—FastForward说明从当前位置快进,媒体保持当前状态参数a)媒体描述符b)快进时间(以毫秒为单位)返回值a)成功b)错误代码7.5.4.4MediaGetMediaDataMedia—GetMediaData描述如下函数名Media——GetMediaData说明获取媒体数据参数a)媒体设备描述符b)媒体输出数据返回值a)成功b)错误代码7.5.4.5MediaGetRectMedia—GetRect描述如下函数名MediaGetRect说明检索目标图像矩形和文本矩形参数a)媒体设备描述符b)图像矩形结构c)文本矩形结构返回值a)成功b)错误代码7.5.4.6MediaGetStateMedia—GetState描述如下函数名MediaGetState说明返回媒体设备的当前状态参数媒体设备描述符返回值媒体设备描述符当前状态7.5.4.7MediaGetTotalTimeMedia—GetTotalTime描述如下函数名Media—GetTotatTime说明返回媒体对象的播放总时长参数媒体设备描述符返回值a)成功b)错误代码1lO 标准分享网www.bzfxw.com免费下载7.S.4.8MediaGetVolumeMedia—GetVolume描述如下GB/T25654—2010函数名Media—GetVolume说明得到当前播放的音量参数a)媒体设备描述符b)音量的输出参数返回值a)成功b)错误代码7.5.4.9MediaPauseMedia—Pause描述如下函数名MediaPause说明暂停媒体播放参数媒体设备描述符返回值a)成功b)错误代码7.5.4.10Media—PlayMedia—Play描述如下函数名MediaPlay说明开始播放指定的媒体参数媒体设备描述符返回值a)成功b)错误代码7.5.4.11MediaResumeMediaResume描述如下函数名MediaResume说明从当前位置恢复指定的媒体参数媒体设备描述符返回值a)成功b)错误代码7.5.4.12MediaRewindMedia—Rewind描述如下函数名MediaRewind说明从当前位置倒退指定的时间参数a)媒体设备描述符b)指定的倒退时间(以毫秒为单位) GB/T25654—2010l返回值a)成功b)错误代码7.5.4.13MediaSeekMedia—Seek描述如下函数名MediaSeek说明定位媒体位置,媒体保持当前状态参数a)媒体设备描述符b)定位引用c)指定的时间(以毫秒为单位)返回值a)成功b)错误代码7.5.4.14MediaSetMediaDataMedia—SetMediaData描述如下函数名Media—SetMediaData说明设置媒体数据,并将媒体置为就绪状态参数a)媒体设备描述符b)要设置的媒体数据返回值a)成功b)错误代码7.5.4.15MediaSetMuteCtlMedia—SetMuteCtl描述如下函数名MediaSetMuteCtl说明将当前音频输出设备设置成静音或取消静音参数a)媒体设备描述符b)静音设置参数返回值a)成功b)错误代码7.5.4.16MediaSetRectMedia—SetRect描述如下函数名Media—SetReet说明设置目标图像矩形和文本矩形。如果媒体数据包含视频或图像信息,将在指定的图像矩形中显示;如果媒体数据包含嵌入式文本信息,将在文本矩形中显示参数a)媒体设备描述符b)图像矩形结构c)文本矩形结构返回值a)成功b)错误代码112 标准分享网www.bzfxw.com免费下载7.5.4.17MediaSetVolumeMedia~SetVolume描述如下GB/T25654—2010函数名Media—SetVolume说明设置当前播放的音量参数a)媒体设备描述符b)要设置的音量返回值a)成功b)错误代码7.5.4.18Media—StopMedia~Stop描述如下函数名MediaStop说明停止对媒体对象进行播放参数媒体设备描述符返回值停止成功/失败7.5.5音频输入控制API7.5.5.1RecorderCreateRecorderCreate描述如下函数名ReeorderCreate说明创建录音器的设备描述符参数无返回值创建成功/失败7.5.5.2Recorder_DestroyRecorder—Destroy描述如下函数名Recorder~Destroy说明释放录音器的设备描述符,释放资源参数录音器的设备描述符返回值销毁成功/失败7.5.5.3RecorderPauseRecorderPause描述如下函数名Recorder—Pause说明暂停录音或播放参数录音器的设备描述符返回值a)成功b)错误代码113 GB/T25654--20107.5.5.4RecorderSetFileRecorder—SetFile描述如下函数名RecorderSetFfie说明设置存放音频文件的文件路径名参数a)录音器的设备描述符b)要设置的存放音频文件的文件路径名返回值a)成功b)错误代码7.5.5.5RecorderStartRecorder—Start描述如下函数名RecorderStart说明开始录音工作参数录音器的设备描述符返回值a)成功b)错误代码7.5.5.6Recorder_StopRecorder—Stop描述如下函数名RecorderStop说明结束录音或者播放声音工作参数录音器的设备描述符返回值a)成功b)错误代码7.5.6摄像输入控制API7.5.6.1CaptureCreateCapture—Create描述如下函数名CaptureCreate说明创建摄像设备的状态描述符参数无返回值a)成功返回状态描述符b)错误7.5.6.2Capture_DestroyCapture—Destroy描述如下函数名Capture—Destroy说明释放摄像设备的状态描述符参数摄像设备的状态描述符返回值成功/失败114 标准分享网www.bzfxw.com免费下载7.5.6.3Capture_SetFileCapture—SetFile描述如下GB/T25654—2010函数名Capture—SetFile说明设置存放摄像文件路径名参数a)摄像设备的状态描述符b)文件路径名,其中相片缺省为jpeg,视频缺省为mpe94返回值a)成功b)错误代码7.5.6.4Capture—SetParmCapture—SetParm描述如下函数名Capture—SetParm说明设置摄像参数参数a)摄像设备的状态描述符b)摄像相关的参数返回值a)成功b)错误代码7.5.6.5Capture_ShotCapture_Shot描述如下函数名CaptureShot说明进行照片拍摄参数摄像设备的状态描述符返回值a)成功b)错误代码7.5.6一Capture—StartCaptureStart描述如下函数名CaptureStart说明开始连续的拍摄参数摄像设备的状态描述符返回值a)成功b)错误代码7.5.6.7Capture—StopCapture—Stop描述如下函数名Capture—Stop说明停止连续的拍摄参数摄像设备的状态描述符返回值a)成功b)错误代码115 8数据交换81信息交换接口811数据交换系统结构数据交换包括同步西汉的选择和定义。同步协议是用于作客户端和服务器之iq通讯的规范.其tl-包括与肄体传输协议(Hf111WS[1)的绑定力式、客户端和服务器交互响应过程、数据表现形式,还保证与现有的Sym.MI终端兼窖。圈6足数据交换的层次结构模型图6数据交换的层次结构数据内容格式在数据交换格式的些础上.进步定义丁实际交换的数据的表小^武,浚格式的统有助于不同厂商的客户端与服务器能够理解并交换数据。标准支持表3中的数据内容格式表3数据交换支持的格式#镕女Ⅻ##自##^ 标准分享网www.bzfxw.com免费下载表3(续)GB/T25654—2010数据类型数据内容格式vMobileXMMC(扩展卡)MP3(音乐)Recorder(录音机)Files(资料中心)Other(其他)其他MIMEMIMEPartOne本条除了全面支持SyncMI,建议的vCard、vCalendar等数据格式之外,还支持YD/T1229--2002的数据格式——vMobilex。8,1.2SyncML应用提供支持的功能函数8.1.2.1TInitDatabaseTInitDatabase描述如下函数名TInitDatabase说明建立与数据管理的联系参数无返回值成功/失败8.1.2.2T—UnlnitDatabaseTUnInitDatabase描述如下函数名T—UnlnitDatabase说明关闭与数据管理的联系参数无返回值成功/失败8.1.2.3T—BackupDatabaseT—BackupDatabase描述如下函数名TBackupDatabase说明备份数据管理——参数无返回值成功/失败8.1.2.4T-RestoreDatabaseTRestoreDatabase描述如下函数名T—RestoreDatabase说明恢复数据管理参数无返回值成功/失败117 GB/T25654—20108.1.2.5TGetAllldTGetAllld描述如下函数名TGetAllld说明获得数据管理所有记录的标识符参数数据管理记录链表返回值成功/失败8.1.2.6TGetldlnfoTGetldlnfo描述如下函数名TGetldlnfo说明获取自上一次同步过程结束后,数据管理变化的信息参数a)上一次同步的时间b)映射标识符的链表c)新增加标识符的链表d)删除标识符的链表e)修改标识符的链表返回值成功/失败8.1.2.7TDelIdRecordT—DelldRecord描述如下函数名TDelldRecord说明删除标识符链表对应的记录参数数据管理标识符记录链表返回值成功/失败8.1.2.8TAddldRecordTl-AddldRecord描述如下函数名TAddIdRecord说明增加标识符链表对应的记录参数记录新增标识符的记录链表返回值成功/失败8.1.2.9TModldRecordT—ModldRecord描述如下函数名T—ModldRecord说明修改标识符链表对应的记录参数要修改的标识符记录链表返回值成功/失败118 标准分享网www.bzfxw.com免费下载210TGetClientRKordInfoTGctClientRecordlnfo描述如下GBIT25654—2010函数名说明根据用户标识符获取对应的记录参数a)客户标讽符b)存放获取数据的内存区域返回值成功/失败82数据管理81数据管理系统模型畿人式数据管理系统,体系结构l:不作l收制.可“采翊(、。s数据管理模刊(般为请求响麻式坼议).也rⅡ“来川“嵌入式链接库”的模型(数据管理系统々特定的廊用程序编洋A起)。嵌^式数据符理的数据模型仍采用鞋值用的“关系”模型。嵛人式数据管理API.主要由环境管理、数据库管理、事务管理、表管理、索引管埋、记录符_哩、游标管理、聚集操作和远程访问接口等部分组成,如图7所示。图7嵌入式数据管理API组成环境管理能为一组并发的数据管理应用同时提供参数设置等北享信且并负责管理当前处于活动状态的数据管理。数据库管理模块提供对其下所有数据表元数据管理的支持,并负责管理事务袁壤引等。事务管理接口提供事务ACID特性的支持,并提供嵌套于事务的支持。表管理接口提供创建、删除、打开、关闭表的操作。索引管理接口提供创建、册0除索引的操作。记录管理接口提供la录插入、查询、删除、更新等功能。游标管理接口提供按指定列字段值顺序访问记录的功能。 GB/T25654—2010聚集操作接口支持访问指定字段求和、均值、最大值、最小值等统计信息。远程访问模块提供远程访问数据库的接口。8.2.2嵌入式数据管理API8.2.2.1EDBMgr_OpenEDBMgr_Open描述如下函数名EDBMgr—Open说明创建环境管理器参数a)环境管理器描述符b)访问权限返回值成功/错误信息8.2.2.2EDBMgr_CloseEDBMgr—Close描述如下函数名EDBMgr——Close说明关闭环境管理器参数环境管理器描述符返回值成功/错误信息8.2.2.3EDBMgr—RemoveEDBMgr—Remove描述如下函数名EDBMgr——Remove说明删除环境管理器参数a)环境管理器描述符b)访问权限返回值成功/错误信息8.2.2.4EDBMgr_SetCacheSizeEDBMgr_SetCacheSize描述如下函数名EDBMgrSetCacheSize说明设置对数据库文件缓存的大小。它允许调用程序有选择地缓冲文件访问,以提高性能。必须在调用打开操作之前调用参数a)环境管理器描述符b)缓存的大小返回值成功/错误信息8.2.2.5EDBMgr_GetCacheSizeEDBMgr_GetCacheSize描述如下l函数名EDBMgr—GetCaeheSizef说明得到当前设置的对数据库文件缓存的大小 标准分享网www.bzfxw.com免费下载GB/T25654—2010参数a)环境管理器描述符b)缓存的大小l返回值成功/错误信息2.2.6EDBDatabase—OpenEDBDatabase—Open描述如下函数名EDBDatabase—Open说明打开指定数据库,如果打开数据库失败,则返回错误码。如果指定的数据库不存在,并且标记为要创建,则创建一个新数据库。如果成功打开数据库,则新创建一个数据库对象用于保存新打开数据库的信息参数a)环境管理器描述符b)数据库对象描述符c)字符串,表示数据库文件名d)指定未找到数据库时是否必须创建数据库返回值成功/错误信息8.2.2.7EDBDatabaseRemoveEDBDatabase—Remove描述如下函数名EDBDatabase——Remove说明删除指定数据管理参数a)环境管理器描述符b)字符串,表示数据库文件名返回值成功/错误信息8.2.2.8EDBDatabaseCloseEDBDatabase—Close描述如下函数名EDBDatabase—Close说明关闭指定数据库参数a)环境管理器描述符b)数据库对象返回值成功/错误信息8.2.2.9EDBDatabaseGetTablesEDBDatabase—GetTables描述如下函数名EDBDatabase—GetTables说明得到当前数据库的所有表信息参数a)数据库描述符b)返回该数据库所有表信息返回值成功/错误信息121 GB/T25654—20102.2.10EDBDatabaseGetAttrsEDBDatabase—GetAttrs描述如下函数名EDBDatabase—GetAttrs说明得到表的所有列信息“参数a)环境管理器描述符b)待查询的表名c)返回所有列名信息返回值成功/错误信息8.2.2.11EDBTxn—BeginEDBTxn—Begin描述如下函数名EDBTxn—Begin说明创建并启动一个事务参数a)待创建事务所依赖的数据库描述符b)存储被创建事务信息标识符c)属性:可以读取脏数据,不同步写Et志(保证ACI特性),同步写日志(保证ACID特性)返回值成功/错误信息8.2.2.12EDBTxnCommitEDBTxn—Commit描述如下函数名EDBTxn—Commit说明用于提交指定事务参数a)待提交事务的对象描述符b)属性:可以读取脏数据,不同步写日志(保证ACI特性),同步写Et志(保证ACID特性)返回值成功/错误信息2.2..3EDBTxn—RollbackEDBTxnRollback描述如下函数名EDBTxn—Rollback说明用于回滚指定事务参数待回滚事务的对象描述符返回值成功/错误信息8.2.2..4EDBTxn—GetDBEDBTxnGetDB描述如下I函数名EDBTxn—GetDBl说明得到指定事务所属的数据管理122 标准分享网www.bzfxw.com免费下载GB/T25654—2010l参数a)待访问的事务对象描述符b)返回事务所属对象描述符l返回值成功/错误信息8.2.2—5EDBTxn—IsRunningEDBTxn—IsRunning描述如下函数名EDBTxn—IsRunning说明判断指定事务是否活动事务参数a)待访问的事务对象描述符b)用于返回事务是否处于活动状态返回值成功/错误信息8.2.2.16EDBTxnSetTimeoutEDBTxnSetTimeout描述如下函数名EDBTxn—SetTimeout说明用于设定事务相关的最长时限(Deadline)参数a)待设定的事务最长时限b)属性:设置事务封锁的失效时间和事务的失效时间返回值成功/错误信息2.17EDBTxnSetTimeoutEDBTxn—SetTimeout描述如下函数名EDBTxn—SetTimeout说明设定执行SQL语句的超时时间参数a)事务设备描述符b)SQl。语句缓冲区所占空间c)SQL语句缓冲区返回值成功/错误信息8.2.2.18EDBTbICreateEDBTbl—Create描述如下函数名EDBTblCreate说明用于创建表参数a)新建表的名字b)新建表所在的路径,为空则在缺省路径创建表c)新建表的列数目d)列属性数组e)待建索引数目f)待建索引对应的列信息数组g)当前操作事务h)属性:使该操作包含在一个事务内,物理删除已存在的文件,提供多线程支持返回值成功/错误信息123 GB/T25654—20108.2.2.19EDBTbl—DropEDBTbl—Drop描述如下函数名EDBTbl—Drop说明删除表参数a)待关闭的表名b)指向当前操作事务句柄返回值成功/错误信息8.2.2.20EDBTbl—OpenEDBTbl—Open描述如下函数名EDBTbl—Open说明打开表参数a)待打开的表名b)输出参数,指向打开的表的设备描述符c)指向当前操作事务的描述符d)属性:使该操作包含在一个事务内,只读模式下打开表,提供多线程支持返回值成功/错误信息EDBTbl—Close描述如下函数名EDBTblClose说明关闭表参数a)待关闭表对象的描述符b)此参数必须设置为0返回值成功/错误信息8.2.2.22EDBldxCreateEDBIdx_Create描述如下函数名EDBIdx_Create说明创建索引参数a)建立索引对应表的表名b)索引名c)索引对应的列数d)相关的列名信息e)当前操作事务返回值成功/错误信息8.2.2.23EDBIdx—DeleteEDBIdx—Delete描述如下124 标准分享网www.bzfxw.com免费下载GB/T25654—2010函数名EDBIdx—Delete说明删除索引参数a)待删除的索引名b)当前操作事务返回值成功/错误信息8.2.2.24EDBRecInsertEDBRee~Insert描述如下函数名EDBRee—Insert说明向数据表插入一条记录参数a)操作的表对象描述符b)指向当前操作事务描述符c)指向待插入记录的描述符d)属性:只有在不存在情况下插入,在数据已存在的情况下插入,使该操作包含在一个事务内返回值成功/错误信息8.2.2.25EDBRec_SelectEDBRec—Select描述如下函数名EDBRee_Select说明从数据表查询记录参数a)操作的表对象描述符b)指向当前操作事务描述符c)查询条件信息d)结果信息e)属性:允许脏读,使该操作包含在一个事务内返回值成功/错误信息8.2.2.26EDBRec—UpdateEDBRec—Update描述如下函数名EDBRec—Update说明更新数据表中满足条件的记录参数a)操作韵表对象描述符b)当前操作事务描述符c)更新条件d)被更新的列数e)被更新列的目标值f)属性:使该操作包含在一个事务内返回值成功/错误信息125 GB/T25654—20108.2.2.27EDBRecDeleteEDBRecDelete描述如下函数名EDBRecDelete说明删除数据表中满足条件的记录参数a)操作的表对象描述符b)当前操作事务设备描述符c)删除表的条件d)属性:使该操作包含在一个事务内返回值成功/错误信息8.2.2.28EDBCsrCreateEDBCsrCreate描述如下函数名EDBCsrCreate说明创建定义在某列上的游标参数a)操作的表对象描述符b)指向当前操作事务描述符c)输出参数,游标对象的描述符d)游标所在的字段名e)属性:允许脏读,允许用游标更新表数据返回值成功/错误信息8.2.2.29EDBCsrCreateCursorOnlndexEDBCsr—CreateCursorOnlndex描述如下函数名EDBCsr—CreateCursorOnIndex说明创建定义在某字段上的游标参数a)操作的表对象描述符b)指向当前操作事务描述符c)输出参数,游标对象的描述符d)游标依赖的索引名e)属性:允许脏读,允许用游标更新表数据返回值成功/错误信息8.2.2.30EDBCsrGetEDBCsr—Get描述如下I函数名EDBCsrGet【说明从游标中获取数据】26 标准分享网www.bzfxw.com免费下载GB/T25654—2010参数a)操作的游标对象描述符b)待返回记录信息的描述符c)属性:返回游标当前指向的记录,返回表的第一条记录,返回表的最后一条记录,返回下一条记录,返回重复记录的下一条记录,返回不重复的下一条记录,返回上一条记录,返回指向匹配的记录返回值成功/错误信息8.2.2.31EDBCsrPutEDBCsr—Put描述如下函数名EDBCsrPUt说明通过游标修改一条记录参数a)操作的游标对象描述符b)待修改的列数目c)待修改列的目标数据信息数组返回值成功/错误信息8.2.2.32EDBCsrDelEDBCsr—Del描述如下函数名EDBCsrDeI说明删除游标当前指定的记录参数操作的游标对象描述符返回值成功/错误信息8.2.2.33EDBCsrCloseEDBCsr—Close描述如下函数名EDBCsrClose说明关闭游标参数操作的游标对象描述符返回值成功/错误信息8.2.2.34EDBCsr_DupCursorEDBCsr—DupCursor描述如下函数名EDBCsr—DupCursor说明复制一个新的游标参数a)操作的游标对象描述符b)输出参数,复制得到的游标对象描述符c)属性:新游标位置初始化成与旧游标一致返回值成功/错误信息8.2.2.35EDBCsr—CountDupsEDBCsrCountDups描述如下127 GB/T25654—2010函数名EDBCsr—CountDups说明获取对应字段与当前游标所指字段相同的重复记录个数参数a)操作的游标对象描述符b)输出信息返回值成功/错误信息8.2.2.36EDBAgrMaxEDBAgr—Max描述如下函数名EDE}Agr—Max说明获取某个列的最大值参数a)操作的表对象描述符b)指向当前操作事务描述符c)进行聚集操作的字段的名称d)输出参数,得到聚集操作结果值返回值成功/错误信息8.2.2.37EDBAgrMinEDBAgr—Min描述如下函数名EDFIAgr—Min说明获取某个列的最小值参数a)操作的表对象描述符b)指向当前操作事务描述符c)进行聚集操作的字段的名称d)输出参数,得到聚集操作结果值返回值成功/错误信息8.2.2.38EDBAgr_CountEDBAgrCount描述如下函数名EDBAgrCount说明获取数据表的记录总数参数a)操作的表对象描述符b)指向当前操作事务描述符c)进行聚集操作的字段的名称d)输出参数,得到聚集操作结果值返回值成功/错误信息8.2.2.39EDBAgrAvgEDBAgr—Avg描述如下128 标准分享网www.bzfxw.com免费下载GB/T25654—2010函数名EDBAgr—Avg说明获取所有记录在某字段上的平均值参数a)操作的表对象描述符b)指向当前操作事务描述符c)进行聚集操作的字段的名称d)输出参数,得到聚集操作结果值返回值成功/错误信息8.2.2.40EDBAgr—SumEDBAgr—Sum描述如下函数名EDBAgr—Sum说明获取某一列的统计和参数a)操作的表对象描述符b)指向当前操作事务描述符c)进行聚集操作的字段的名称d)输出参数,得到聚集操作结果值返回值成功/错误信息2.2.41EDBRemoteInitConnectionEDBRemote—InitConnection描述如下函数名EDBRemotejnitConnection说明和远程数据管理建立起连接参数a)存放远程数据管理连接描述符b)远程数据管理服务器的地址c)远程数据管理服务器访问端口d)登录远程数据管理服务器的用户名e)登录远程数据管理服务器的密码f)要操纵的远程数据管理库名返回值成功/错误信息2.2.42EDBRemoteReleaseConnectionEDBRemote—ReleaseConnection描述如下函数名EDBRemote—ReleaseConnection说明释放和远程数据管理服务器建立起的连接,通知远程数据管理服务器释放资源参数连接描述符,标识和远程数据管理服务器建立的连接返回值成功/错误信息129 GB/T25654—20108.2.2.43EDBRemoteInsertItemEDBRemoteInserthem描述如下函数名EDBRemote—InsertItem说明向远程数据管理表中插入一条记录参数a)连接描述符,标识和远程数据管理服务器建立的连接b)被访问的表名c)被插人数据信息返回值成功/错误信息8.2.2.44EDBRemoteSelectltemEDBRemote—SelectItem描述如下函数名EDBRemote—Selectltem说明从远程数据管理中执行查询操作参数a)连接描述符,标识和远程数据管理服务器建立的连接b)被访问的表名c)查询条件(关键字条件查询)d)存储返回的查询结果返回值成功/错误信息2.2.45EDBRemote_UpdateltemEDBRemote—UpdateItem描述如下函数名EDBRemote—Updateltem说明更新远程数据管理表中关键字为符合条的记录参数a)连接描述符,标识和远程数据管理服务器建立的连接b)被访问的表名c)更新条件d)存储返回的查询结果e)被更新的新值f)属性:使该操作包含在一个事务内返回值成功/错误信息8.2.2.46EDBRemoteSelectItemEDBRemote—SelectItem描述如下函数名EDBRemoteSelectItem说明从远程数据管理中执行查询操作参数a)连接描述符,标识和远程数据管理服务器建立的连接b)被访问的表名c)查询条件(关键字条件查询)d)存储返回的查询结果返回值成功/错误信息130 标准分享网www.bzfxw.com免费下载2.47EDBRemoteExecSQLEDBRemote—ExecSQL描述如下GB/T25654—2010函数名EDBRemote—ExecSQL说明删除远程数据管理表中关键字符合条件的记录参数a)连接描述符,标识和远程数据管理服务器建立的连接b)被访问的表名c)条件表达式返回值成功/错误信息8.2.2.48EDBRemoteDeleteltemEDBRemoteDeleteltem描述如下函数名EDBRemote—DeleteItem说明向远程数据管理发送SQI,语句执行参数a)连接描述符,标识和远程数据管理服务器建立的连接b)sQL语句缓冲区所占空间c)sQL语句缓冲区d)执行返回结果返回值成功/错误信息9电源管理9..dpm—initdpm—ink描述如下函数名dpminit说明初始化DPM参数无返回值初始化成功/失败dpm—terminatedpm—terminate描述如下函数名dpm—terminate说明结束DPM功能参数无返回值成功/失败9一dpm—disabledpm—disable描述如下l函数名dpm—disableI说明暂时停止DPM功能131 GB/T25654—2010l参数无I返回值停止成功/失败9.4dpm—enabledpm—enable描述如下函数名dpmenable说明使DPM恢复工作参数无返回值恢复成功/失败9.5dpm_set——osdpm—setos描述如下函数名dpmsetos说明当系统操作状态发生改变,而需要一个新的操作点支持时,通知系统需要更换操作点参数新操作点返回值无9一dynamicpm—suspenddynamicpm—suspend描述如下函数名dynamicpm—suspend说明通过系统的挂起代码,安全的保存现在操作点的内容参数无返回值成功/失败9.7dynamicpmresumedynamicpm—resume描述如下函数名dynamicpm—resume说明根据提供的操作点名称建立一个操作点参数无返回值无9.8dpm——createoptdpmcreate—opt描述如下函数名dpm——create——opt说明根据提供的操作点名称建立一个操作点参数a)新建操作点名称b)操作点信息返回值建立成功/失败 标准分享网www.bzfxw.com免费下载9.9dpm—create—policydpm—create—policy描述如下GB/T25654—2010函数名dpm—.create——policy说明根据提供的策略名称建立一个电源管理策略参数a)电源管理策略名称b)操作点名称集合返回值建立成功/失败9—0dpm_set—policydpm—set—policy描述如下函数名dpm—、set——policy说明根据提供的策略名称激活一个电源管理策略参数电源管理策略名称返回值激活成功/失败9.11dpm—geLpolicydpmget—policy描述如下函数名dpm—.get——policy说明获得现在正在使用的电源管理策略的名称参数电源管理策略名称返回值成功/失败9.12dpm—set—task—statedpm—set—task—state描述如下函数名dpm——set——task——state说明根据提供的任务标识号和状态设置相应任务的状态参数a)任务标识号b)任务状态返回值成功/失败9.13dpm—get—taskstatedpm—get—task—state描述如下函数名dpm、—get——task——state说明获得指定进程号进程的状态参数a)进程号b)输出的进程状态结构返回值成功/失败 GB/T25654—20109..4dpm—check—constraintsdpm—check—constraints描述如下函数名dpm——check——constraints说明检测操作点是否符合当前系统约束的函数参数操作点结构信息返回值检测约束成功/失败 标准分享网www.bzfxw.com免费下载说明GB/T25654—2010参考文献[1]GB/T17192(所有部分)信息技术计算机图形与图形设备会话的接口技术(CGI)功能[2]GB/T182202000手持式个人信息处理设备通用规范[3]GB/T180312000信息技术数字键盘汉字输入通用要求[4]GB/T187902002联机手写汉字识别技术要求与测试规程[5]GB/T192452003电子名片信息交换规范[6]IEEEstd1003.1:1990POSIX可移植操作系统核心服务接口[7]IEEEstd1003.1h:1993POSIX可移植操作系统实时扩展服务接口[8]IEEEstd1003.1c:1995POSIX可移植操作系统线程扩展服务接口L9]JSR30Connected,LimitedDeviceConfigurationCLDC1.0[10]JSR37MobileInformationDeviceProfile1.0『11]JSRll8MobileInformationDeviceProfile2.0[12]JSRl20WirelessMessagingAPI1.0[13]JSRl35MultiMediaAPIL14]JSRl39Connected,LimitedDeviceConfigurationCLDC1.1[153JSRl72WebServices[16]JsRl79LocationAPIforJ2ME【17]jsRl84Mobile3DGraphics[18]JSRl85JavaTechnologyfortheWirelessIndustry(JTWI)'