2国产品牌机游戏产品开发手册-LAV格式技术分册-中国移

1、 中国移动通信企业标准中国移动通信企业标准QB-QB-国产品牌机国产品牌机中间件游戏开发手册LAV格式技术分册（试行）Game DevelopmentGame Development Specification of Game Master Platform 版本号：版本号：1.0.0-实施-发布中国移动通信有限公司 发布中国移动通信有限公司 发布目录TOC h z t QB标题1,1,QB标题2,2,QB标题3,3,QB附录,1 HYPERLINK l _Toc276131741 1.范围围 PAGEREF _Toc276131741 h 5 HYPERLINK l _Toc27613174

2、2 2.修订订历史 PAGEREF _Toc276131742 h 5 HYPERLINK l _Toc276131743 3.规范范性引用用文件 PAGEREF _Toc276131743 h 5 HYPERLINK l _Toc276131744 4.术语语、定义义和缩略略语 PAGEREF _Toc276131744 h 6 HYPERLINK l _Toc276131745 5.开发发工具、测测试手机机获取及及技术支支持联系系方式 PAGEREF _Toc276131745 h 7 HYPERLINK l _Toc276131746 6.应用用开发接接口描述述 PAGEREF _Toc

3、276131746 h 7 HYPERLINK l _Toc276131747 6.1.数据类类型 PAGEREF _Toc276131747 h 7 HYPERLINK l _Toc276131748 6.2.文件系系统 PAGEREF _Toc276131748 h 8 HYPERLINK l _Toc276131749 6.2.11.IVFFS文件件名命名名规则 PAGEREF _Toc276131749 h 8 HYPERLINK l _Toc276131750 6.2.22.IVFFS与doss文件系系统的区区别 PAGEREF _Toc276131750 h 9 HYPERLINK

4、 l _Toc276131751 6.2.33.虚拟路路径与实实际路径径 PAGEREF _Toc276131751 h 9 HYPERLINK l _Toc276131752 6.2.44.改变虚虚拟根目目录 PAGEREF _Toc276131752 h 9 HYPERLINK l _Toc276131753 6.2.55.共享目目录 PAGEREF _Toc276131753 h 9 HYPERLINK l _Toc276131754 6.2.66.homme目录录 PAGEREF _Toc276131754 h 10 HYPERLINK l _Toc276131755 6.3.存储结结

5、构 PAGEREF _Toc276131755 h 10 HYPERLINK l _Toc276131756 6.3.11.目录操操作 PAGEREF _Toc276131756 h 10 HYPERLINK l _Toc276131757 6.3.22.分区操操作 PAGEREF _Toc276131757 h 10 HYPERLINK l _Toc276131758 6.3.33.文件查查找 PAGEREF _Toc276131758 h 11 HYPERLINK l _Toc276131759 6.3.44.文件操操作 PAGEREF _Toc276131759 h 12 HYPERLI

6、NK l _Toc276131760 6.4.显示设设备 PAGEREF _Toc276131760 h 12 HYPERLINK l _Toc276131761 6.4.11.DC资源源 PAGEREF _Toc276131761 h 13 HYPERLINK l _Tooc277613317662 6.44.2.LCDD显示设设备 PAGEREF _Toc276131762 h 13 HYPERLINK l _Toc276131763 6.4.33.用户显显示设备备 PAGEREF _Toc276131763 h 13 HYPERLINK l _Toc276131764 6.4.44.资源

7、数数据的复复制 PAGEREF _Toc276131764 h 14 HYPERLINK l _Toc276131765 6.44.5.释放DCC资源 PAGEREF _Toc276131765 h 14 HYPERLINK l _Toc276131766 6.4.66.显示设设备信息息 PAGEREF _Toc276131766 h 14 HYPERLINK l _Toc276131767 6.4.77.复制模模式 PAGEREF _Toc276131767 h 15 HYPERLINK l _Toc276131768 6.4.88.显示缓缓冲区 PAGEREF _Toc276131768

8、h 15 HYPERLINK l _Toc276131769 6.5.显示设设备的绘绘图 PAGEREF _Toc276131769 h 16 HYPERLINK l _Toc276131770 6.6.显示设设备的字字符打印印 PAGEREF _Toc276131770 h 19 HYPERLINK l _Toc276131771 6.7.图片显显示 PAGEREF _Toc276131771 h 20 HYPERLINK l _Toc276131772 6.7.11.BMPP显示 PAGEREF _Toc276131772 h 20 HYPERLINK l _Toc276131773 6.

9、7.22.GIFF显示 PAGEREF _Toc276131773 h 21 HYPERLINK l _Toc276131774 6.7.33.JPGG显示 PAGEREF _Toc276131774 h 21 HYPERLINK l _Toc276131775 6.7.44.PNGG显示 PAGEREF _Toc276131775 h 22 HYPERLINK l _Toc276131776 6.8.GUII的使用用 PAGEREF _Toc276131776 h 23 HYPERLINK l _Toc276131777 6.8.11.GUII运行机机制 PAGEREF _Toc276131

10、777 h 23 HYPERLINK l _Toc276131778 6.8.22.IWIIN消息息 PAGEREF _Toc276131778 h 23 HYPERLINK l _Toc276131779 6.8.33.基本函函数 PAGEREF _Toc276131779 h 27 HYPERLINK l _Toc276131780 6.8.44.控件 PAGEREF _Toc276131780 h 32 HYPERLINK l _Toc276131781 66.8.5.菜单 PAGEREF _Toc276131781 h 41 HYPERLINK l _Toc276131782 6.8.

11、66.对话框框 PAGEREF _Toc276131782 h 43 HYPERLINK l _Toc276131783 6.9.事件机机制 PAGEREF _Toc276131783 h 46 HYPERLINK l _Toc276131784 6.9.11.事件概概述 PAGEREF _Toc276131784 h 46 HYPERLINK l _Toc276131785 6.9.22.事件处处理机制制 PAGEREF _Toc276131785 h 47 HYPERLINK l _Toc276131786 6.9.33.按键事事件 PAGEREF _Toc276131786 h 47 H

12、YPERLINK l _Toc276131787 6.9.44.定时器器事件 PAGEREF _Toc276131787 h 50 HYPERLINK l _Toc276131788 6.9.55.用户自自定义事事件 PAGEREF _Toc276131788 h 51 HYPERLINK l _Toc276131789 6.10.多线程程处理 PAGEREF _Toc276131789 h 52 HYPERLINK l _Toc276131790 6.10.1.创建线线程 PAGEREF _Toc276131790 h 52 HYPERLINK l _Toc276131791 6.10.2.

13、销毁线线程 PAGEREF _Toc276131791 h 52 HYPERLINK l _Toc276131792 6.10.3.线程运运行级别别 PAGEREF _Toc276131792 h 53 HYPERLINK l _Toc276131793 6.10.4.线程睡睡眠 PAGEREF _Toc276131793 h 53 HYPERLINK l _Toc277613317994 6.110.55.判断线线程是否否未被挂挂起 PAGEREF _Toc276131794 h 53 HYPERLINK l _Toc276131795 6.10.6.获得当当前线程程句柄 PAGEREF _

14、Toc276131795 h 53 HYPERLINK l _Toc276131796 6.10.7.获得未未被挂起起线程个个数 PAGEREF _Toc276131796 h 53 HYPERLINK l _Toc277613317997 6.110.88.挂起指指定线程程 PAGEREF _Toc276131797 h 54 HYPERLINK l _Toc276131798 6.10.9.唤醒指指定线程程 PAGEREF _Toc276131798 h 54 HYPERLINK l _Toc276131799 6.10.10.终止指指定线程程 PAGEREF _Toc276131799

15、h 54 HYPERLINK l _Toc276131800 6.110.111.中断指指定线程程 PAGEREF _Toc276131800 h 54 HYPERLINK l _Toc276131801 6.10.12.Locck、UnLLockk和Waiit、Nottifyy PAGEREF _Toc276131801 h 54 HYPERLINK l _Toc276131802 6.10.13.Locck() PAGEREF _Toc276131802 h 55 HYPERLINK l _Toc227611318803 6.110.114.UnLLockk() PAGEREF _Toc2

16、76131803 h 55 HYPERLINK l _Toc276131804 6.10.15.Waiit() PAGEREF _Toc276131804 h 55 HYPERLINK l _Toc276131805 6.10.16.Nottifyy() PAGEREF _Toc276131805 h 55 HYPERLINK l _Toc276131806 6.11.多媒体体功能 PAGEREF _Toc276131806 h 56 HYPERLINK l _Toc276131807 6.11.1.多媒体体简介 PAGEREF _Toc276131807 h 56 HYPERLINK l _

17、Toc276131808 6.11.2.音频播播放 PAGEREF _Toc276131808 h 56 HYPERLINK l _Toc276131809 6.11.3.音频录录制 PAGEREF _Toc276131809 h 58 HYPERLINK l _Toc276131810 6.11.4.视频播播放 PAGEREF _Toc276131810 h 59 HYPERLINK l _Toc276131811 6.12.通信接接口 PAGEREF _Toc276131811 h 62 HYPERLINK l _Toc276131812 6.12.1.网络编编程接口口 PAGEREF _

18、Toc276131812 h 62 HYPERLINK l _Toc276131813 6.12.2.设置/获取当当前网络络环境 PAGEREF _Toc276131813 h 63 HYPERLINK l _Toc276131814 6.12.3.套接字字的创建建 PAGEREF _Toc276131814 h 63 HYPERLINK l _Toc276131815 6.12.4.套接字字的关闭闭 PAGEREF _Toc276131815 h 64 HYPERLINK l _Toc276131816 6.12.5.套接字字的绑定定 PAGEREF _Toc276131816 h 64 H

19、YPERLINK l _Toc276131817 6.12.6.进入监监听状态态 PAGEREF _Toc276131817 h 64 HYPERLINK l _Toc276131818 6.12.7.接受连连接请求求 PAGEREF _Toc276131818 h 64 HYPERLINK l _Toc276131819 6.12.8.连接到到远程服服务器 PAGEREF _Toc276131819 h 64 HYPERLINK l _Toc276131820 6.12.9.数据接接收 PAGEREF _Toc276131820 h 65 HYPERLINK l _Toc276131821

20、6.12.10.数据发发送 PAGEREF _Toc276131821 h 65 HYPERLINK l _Toc277613318222 6.112.111.域名解解析 PAGEREF _Toc276131822 h 66 HYPERLINK l _Toc276131823 6.12.12.获取数数据包最最大长度度 PAGEREF _Toc276131823 h 66 HYPERLINK l _Toc276131824 6.12.13.套接字字出错信信息 PAGEREF _Toc276131824 h 67 HYPERLINK l _Toc2761318825 6.112.114.网络事事件

21、 PAGEREF _Toc276131825 h 67 HYPERLINK l _Toc276131826 6.13.手机系系统应用用 PAGEREF _Toc276131826 h 1 HYPERLINK l _Toc276131827 6.13.1.手机震震动 PAGEREF _Toc276131827 h 1 HYPERLINK l _Toc276131828 6.13.2.开始震震动 PAGEREF _Toc276131828 h 1 HYPERLINK l _Toc276131829 6.13.3.停止震震动 PAGEREF _Toc276131829 h 1 HYPERLINK l

22、 _Toc276131830 6.13.4.SIMM卡函数数 PAGEREF _Toc276131830 h 1 HYPERLINK l _Toc276131831 6.14.系统应应用接口口 PAGEREF _Toc276131831 h 2 HYPERLINK l _Toc276131832 6.14.1.计费接接口 PAGEREF _Toc276131832 h 2 HYPERLINK l _Toc276131833 6.14.2.输入法法函数 PAGEREF _Toc276131833 h 3 HYPERLINK l _Toc276131834 6.14.3.MD55校验 PAGERE

23、F _Toc276131834 h 4 HYPERLINK l _Toc276131835 6.14.4.其它 PAGEREF _Toc276131835 h 5 HYPERLINK l _Toc276131836 7.附录录 PAGEREF _Toc276131836 h 7 HYPERLINK l _Toc276131837 附录A：国国产品牌牌机中间间件KJJAVAA游戏转转化对JSRR标准支支持程度度 PAGEREF _Toc276131837 h 7前言本标准规定定了LAAV格式式游戏的的开发接接口及相相关协议议，是各各游戏开开发商开开发文档档，以满满足游戏戏开发要求求。本标准主要要

24、包括以以下几方方面内容容：数据据类型和和接口要要求等。本标准由中中移 号文文件印发发。本标准由中中国移动动通信有有限公司司技术部部提出并并归口。本标准由中中国移动动通信有有限公司司技术部部负责解解释，具具体细节节由中国国移动通通信有限限公司负负责解释释。本标准起草草单位：中国移移动通信信游戏基基地本标准主要要起草人人： 范围本标准规定定了基于于高阳虚虚拟机开开发游戏戏的开发发接口，供供各游戏戏CP/SP在在开发游游戏时使使用。修订历史时间内容版本号作者2010-10-251.0.00规范性引用用文件下列标准所所包含的的条文，通通过在本本标准中中引用而而成为本本标准的的条文。本本标准出出版时，所

25、所示版本本均为有有效。所所有标准准都会被被修订，使使用本标标准的各各方应探探讨使用用下列标标准最新新版本的的可能性性。ELF 可可执行链链接文件件格式标标准，可可执行链链接文件件格式是是UNIIX系统统实验室室（USSL)作作为应用用程序二二进制接接口（AAppllicaatioon BBinaary Intterffacee(ABBI)而而开发和和发布的的。工具具接口标标准委员员会（TTIS)现在了了可在发发展中的的ELFF标准作作为工作作在322位体系系上不同同操作系系统之间间的二进进制文件件格式。RFC18867 Forrm-bbaseed FFilee Upploaad iin HHT

26、MLLRFC19945 Hyyperrtexxt TTrannsfeer PProttocool HHTTPP/1.0RFC20068 Hyyperrtexxt TTrannsfeer PProttocool HHTTPP/1.1RFC26616 Hyyperrtexxt TTrannsfeer PProttocool HHTTPP/1.1 断断点续传传CLDC规规范：目目前分为为v1.0JSSR300，v11.1JJSR1139CDC规范范：目前前分为vv1.00JSRR36，vv1.11JSRR2188MIDP规规范：分分为v11.0JJSR337，vv2.00JSRR1188IMP规范范

27、：JSSR1995FP规范：JSRR46PP规范：JSRR62WirellesssMesssagginggAPII(WMMA);JSRR1200,JSSR2005无线线信息规规范，提提供短信信和彩信信功能MobilleMeediaaAPII(MMMAPII);JJSR1135移移动媒体体规范，提提供音频频视频播播放LocattionnAPIIforrJ2MME(JJSR-1799)定位位规范，提提供定位位功能SIPAPPIfoorJ22ME(JSRR-1880)提提供对会会话发起起协议的的支持SecurrityyanddTruustSServviceesAPPIfoorJ22ME(JSRR-1

28、777)提提供网络络安全与与信任的的支持Mobille3DDGraaphiics(JSRR-1884)提提供对33D绘图图的支持持J2MEWWebSServviceesAPPIs(WSAA),JJSR1172提提供对WWebSServvicees的支支持BluettootthAPPI(JJSR-82,Mottoroola,JavvaPaartnnerSSitee)提供供对兰牙牙的支持持PDAOpptioonallPacckaggesfforttheJJ2MEEPlaatfoorm(JSRR75)提供对对PDAA中文件件、通信信录等存存取的支支持PersoonallBassisPProffile

29、e(PBBP)(JSRR-1229)类类似于PPP的规规范，但但在图形形界面方方面无需需支持AAWTJ2MERRMIOOptiionaalPaackaage,(RMMIOPP);JJSR666提供供对远程程调用的的支持JDBCOOptiionaalPaackaagefforCCDC/FouundaatioonPrrofiileAAPI(JSRR-1669)提提供对JJDBCC的支持持术语、定义义和缩略略语下列术语、定义和缩缩略语适适用于本本标准：词语解释OTAOver Thee Aiir, 即空中中、无线线方式HTTPHyperr Teext Traansffer Prootoccol，超超文

30、本传传输协议议XMLeXtennsibble Marrkupp Laanguuagee 可可扩展标标记语言言SOAPSimplle OObjeect Acccesss Prrotoocoll 简单单对象访访问协议议CPConteent Proovidder内内容提供供商SPServiice Proovidder 服务提提供商CMGP游戏业务平平台业务网元指www porrtall、 wwap porrtall、 网网游服务务器等CDCConneecteed DDeviice Connfigguraatioon 连连接设备备配置CLDCConneecteedLiimittedDDeviiceCC

31、onffiguurattionn 连接接限制设设备配置置MIDPMobilleInnforrmattionnDevviceesPrrofiile 移动信信息设备备表MD5Messaage Diggestt Allgorrithhm 信信息摘要要算法开发工具、测测试手机机获取及技技术支持持联系方方式LAV格式式游戏的的开发，由高阳公司免费获取相应的开发工具及技术支持：联系方式北京高阳圣圣思园信信息技术术有限公公司，电电话133810048552244，邮件件gammemLAV格式式游戏开开发工具具包括：开发SDKK开发测试模模拟器编译打包工工具2010年年内，SSP/CCP合作作伙伴开开发LAA

32、V格式式的游戏戏，由高高阳公司司协助提提供真机机测试。2011年年后，SSP/CCP合作作伙伴按按游戏基基地下发发的国国产品牌牌机游戏戏平台终终端支持持列表购购买测试试手机，并由高阳阳公司提提供测试试机相应应支持。应用开发接接口描述述数据类型数据类型位数取值范围char8-128 1227unsiggnedd chhar80 2255signeed ccharr8-128 1227shortt16-32 7768 322 7667unsiggnedd shhortt160 665 5535signeed sshorrt16-32 7768 322 7667int32-2 1447 4483 6

33、488 2 1477 4883 6647unsiggnedd innt320 44 2994 9967 2955signeed iint32-2 1447 4483 6488 2 1477 4883 6647floatt327位有效数数字,11E-338 1EE+388doublle6415位有效效数字,1E-3088 1E+3088文件系统虚拟机平台台采用独独有的虚虚拟文件件系统(IVFFS)。 IVFSS文件名名命名规规则文件名第一一个字母母不允许许是.（.作为特特殊用途途）文件名中不不允许出出现下列列字符： / : ? * |IVFS与与doss文件系系统的区区别 同同linnux一一样

34、，IIVFSS采用/作为路路径分隔隔符，而而doss一般以以作为为路径分分隔符（也也支持/）。同linuux一样样，IVVFS没没有盘符符概念，而而doss的路径径是可以以包含盘盘符的。同linuux一样样，IVVFS的的绝对路路径总是是以/开开头，而而doss的绝对对路径以以盘符开开头。虚拟路径与与实际路路径虚拟机平台台的所有有文件操操作基于于一个虚虚拟根目目录一个程序启启动后，其其虚拟根根目录就就是这个个程序所所在目录录下与其其同名的的子目录录。例如：d:/hiisunn/deemo.avaa启动后后其虚拟拟根目录录是d:/ hissun /deemo假如d:/hissun/demmo.a

35、ava启启动后执执行了下下面语句句：SeetCuurreentDDir(/dd1);上述/d11是就是是IVFFS的虚虚拟目录录，转换换为实际际磁盘目目录是dd:/hhisuun/ddemoo/d11总结：把虚虚拟根目目录与虚虚拟绝对对路径连连接起来来就得到到实际路路径通过为每一一个Laav程序序设定各各自的虚虚拟根目目录，LLav程程序的文文件操作作限定在在一定范范围内，从从而保证证了系统统的安全全。改变虚拟根根目录一个通过认认证的LLav程程序可以以使用SSetRRoott来改变变虚拟根根目录。int SSetRRoott(chhar *diir,iint flaag);函数说明：改变虚虚

36、拟根目目录参数说明：dirr原虚虚拟根目目录flag设置置homme目录录标记，00和1有有效。返 回：成成功返回回1，失失败返回回0注 意：若若不想改改变hoome目目录，fflagg不要传传入1。void SettRoootHoome(voiid);函数说明：将rooot目目录设置置成hoome目目录。共享目录虚拟根目录录把各个个Lavv程序能能操作的的文件空空间隔开开了。有有时候需需要有一一些资源源在所有有Lavv程序间间共享，所所以就引引入了共共享目录录概念。当用户需要要访问共共享目录录时，就就要以.shaare/开头，加加上要访访问的文文件路径径。在MMTK平平台上，共共享目录录暂时

37、为为第一存存储体的的hissun/Shaare/目录。例如：.ssharre/wwinddowss.bmmp实际际上对应应的就是是第一存存储体的的hissun/Shaare/winndowws.bbmp。对于Shaare中中的文件件，只能能通过UUSB拷拷贝进去去。所谓谓第一存存储体指指的是第第一个可可使用UUSB数数据线访访问到的的手机磁磁盘。一般文件操操作是不不能操作作共享目目录的。能接受.ssharre开头头的路径径的函数数有：ffopeen（），仅仅以只读读方式打打开、LLoaddBmpp()、LLoaddGiff()、GGetGGifIInfoo()、 LoaadJppg()、Pll

38、aySSounnd()、 PPlayyViddeo()、SSetRRoott()、RegisterFont()、GetSoundDuration()、GetVideoDuration()。home目目录home目目录以.homme开头头。一个Lavv程序启启动后，hhomee目录就就是其虚虚拟根目目录。当当用SeetRooot切切换了虚虚拟根目目录后，hhomee目录保保持不变变，这样样Lavv程序就就能随时时访问自自己的资资源。一般文件操操作是不不能操作作homme目录录的。能接受.hhomee开头的的路径的的函数有有：LooadBBmp(),LLoaddGiff(), GeetGiifIn

39、nfo(), LoaadJppg(),PllaySSounnd(),PllayVVideeo(),SeetRooot()。存储结构目录操作当应用程序序启动时时，虚拟拟机平台台会将当当前目录录设置成成应用程程序匹配配的资源源目录，所所以应用用程序无无需知道道该目录录下的文文件在本本地磁盘盘上的绝绝对路径径，也能能正确访访问该文文件。带目录的文文件名和和目录名名都是一一个字符符串，如如“d:/HissunIIDE/Ressourrce”。虚拟拟机平台台规定的的目录分分隔符为为“/”而不是是“”,并且且使用相相对路径径时，第第一个目目录前不不要加目目录分隔隔符。跟目录相关关的功能能接口有有：1）in

40、tt GeetCuurreentDDir(chaar *bufff, sizze_tt siize);函数功能：得到当当前目录录绝对路路径。参数说明：bufff存储返返回的绝绝对路径径字符串串的缓冲冲区；sizebuuff缓缓冲区的的大小。返 回：返返回非00成功，返返回0失失败。2）intt SeetCuurreentDDir(connst chaar *dirr);函数功能：用指定定的绝对对路径设设置当前前目录。参数说明：dirr需要要设置的的相对路路径或绝绝对路径径字符串串。返 回：返返回非00成功，返返回0失失败。3）intt CCreaateDDir(connst chaar *di

41、rr);函数功能：创建目目录。参数说明：dirr将要要创建的的目录名名称字符符串。返 回：返返回非00成功，返返回0失失败。分区操作除了目录接接口外，虚虚拟机平平台还将将目标系系统的存存在的磁磁盘名称称提供给给用户，使使得应用用程序不不必局限限于当前前目录所所在的磁磁盘。int EnuumDrrivee(vooid);函数功能：获得可可用逻辑辑驱动器器。返 回：表表示当前前系统可可用的驱驱动器的的位掩码码，低226位有有效，第第0位表表示驱动动器A，第第1位表表示驱动动器B，第第2位表表示驱动动器C，依依次类推推，函数数调用失失败则返返回值为为0。文件查找虚拟机平台台提供了了搜索出出当前目目录

42、下所所有符合合匹配规规则的文文件或目目录的功功能。匹匹配规则则是一个个由“*”或“?”组合而而成的字字符串。一个完整的的文件查查找步骤骤，首先先要根据据匹配字字符串建建立查找找并返回回第一个个匹配文文件名和和查找句句柄，然然后根据据查找句句柄一个个一个查查找剩余余文件，直直到没有有匹配文文件为止止，最后后要把文文件查找找句柄关关闭以释释放资源源。与三个查找找步骤相相关的功功能接口口有：建立查找HANDLLE FFinddFirrstFFilee(coonstt chhar *fiile, chhar *buuff, siize_t ssizee, FFINDD_DAATA *atttr);函数

43、功能：建立匹匹配查找找并查找找第一个个匹配文文件或目目录。参数说明：fille指定的的匹配规规则字符符串，支支持*和?。buff存储储返回的的查找到到文件或或目录名名称字符符串的缓缓冲区；size缓冲冲区buuff的的大小；attr查找找到的文文件或目目录属性性。返 回：供供查找下下一个匹匹配文件件使用的的文件查查找句柄柄，返回回-1则则表示出出错。attr的的类型是是一个查查找属性性结构体体，结构构体的定定义和每每个成员员的意义义如下：typeddef strructtunsiigneed iint FilleAtttriibuttes;/文文件属性性unsiigneed iint Fill

44、eSiize;/文文件大小小unsiigneed iint DatteTiime;/文文件生成成DOSS时间int Resservved;/保保留字节节 FINND_DDATAA;虚拟机平台台对于文文件属性性有如下下定义，FILE_ATTRIBUTE_NORMAL表示一般文件，FILE_ATTRIBUTE_READONLY表示只读文件，FILE_ATTRIBUTE_HIDDEN表示隐藏文件，FILE_ATTRIBUTE_SYSTEM表示系统文件，FILE_ATTRIBUTE_DIRECTORY表示目录，FILE_ATTRIBUTE_ARCHIVE表示存档文件。文件DOSS时间DDateeTim

45、me的格格式如下下：typeddef strructt unnsiggnedd innt SSecoond22:5;/Seeconnd ddiviidedd byy 2 unnsiggnedd innt MMinuute:6;/ Minnutee (00599) unnsiggnedd innt HHourr:5;/ Houur (0223 oon aa 244-hoour cloock) unnsiggnedd innt DDay:5;/ Dayy off thhe mmontth (1331) unnsiggnedd innt MMontth:44;/ Monnth (1 = JJanuu

46、aryy, 22 = Febbruaary, ettc.) unnsiggnedd innt YYearr19880:77;/ Yeaar ooffsset froom 119800 (aadd 19880 tto gget acttuall yeear) DOSSDatteTiime;查找下一个个匹配文文件int FinndNeextFFilee (HHANDDLE hanndlee, ccharr *bbufff, ssizee_t sizze, FINND_DDATAA *aattrr);函数功能：查找下下一个匹匹配文件件或目录录。参数说明：hanndlee文件件查找句句柄；buff存储

47、储返回的的查找到到文件或或目录名名称字符符串的缓缓冲区；size缓冲冲区buuff的的大小；attr查找找到的文文件或目目录属性性。返 回：返返回非00表示已已成功查查找到，返返回0表表示查找找失败,已经没没有匹配配文件。关闭文件查查找文件查找的的句柄是是一种系系统资源源，当不不需要继继续查找找或已经经查找完完毕后，应应用程序序需要主主动关闭闭文件查查找，释释放系统统资源。int FinndCllosee (HHANDDLE hanndlee);函数功能：关闭文文件查找找。参数说明：hanndlee文件件查找句句柄。返 回：返返回非00成功，返返回0失失败。文件操作虚拟机平台台对文件件操作的的

48、扩展函函数有：size_t FilleSiize (FIILE* fiile);函数功能：获得文文件大小小参数说明：fille已经打打开的文文件句柄柄返 回：文文件大小小，以字字节为单单位显示设备DC资源DC是用来来管理图图形设备备的数据据结构，它它定义了了一系列列的相关关属性和和影响图图形输出出的图形形模式。每每个DCC都由显显示缓冲冲区来存存储显示示内容，由由虚拟机机平台管管理。用用户也可可以得到到指定DDC显示示缓冲区区的首地地址，从从而做一一些高效效或特殊殊的操作作。DC是有限限的系统统资源，应应用程序序可以通通过设备备句柄HHDC操操作，不不用时必必须释放放，否则则会导致致资源泄泄漏

49、。DC分为用用户显示示设备和和LCDD显示设设备两种种，只有有LCDD显示设设备才能能将显示示缓冲区区的内容容直接显显示出来来。用户户显示设设备必须须先通过过APII将显示示内容拷拷贝到LLCD的的DC上上。LCD显示示设备LCD显示示设备描描述了LLCD的的信息，并并且可以以通过它它的设备备句柄操操作LCCD的显显示缓冲冲区。以以下列出出了与LLCD显显示设备备相关的的函数。HDC GGetSScreeenDDC(vvoidd);函数功能：获得LLCD显显示设备备句柄。返 回：若若函数调调用成功功，则返返回值为为LCDD的显示示设备句句柄，否否则返回回0。说 明：该该函数可可多次使使用，每每

50、次系统统都会创创建一个个设备结结构，但但是所有有的设备备结构的的显示缓缓冲区的的地址都都一样。当当不需要要使用的的时候，请请注意释释放，当当释放的的时候仅仅仅释放放设备结结构。void UpddateeAreea(HHDC hdcc);函数功能：显示LLCD显显示设备备剪切区区的内容容。参数说明：hdccLCCD显示示设备的的句柄，不不可传入入用户自自创建的的DC句句柄。说 明：当当用户自自己创建建的DCC需要显显示时，需需要将其其内容拷拷贝到LLCD显显示设备备，然后后再使用用UpddateeAreea显示示。用户显示设设备用户显示设设备是由由应用程程序创建建的显示示设备。通通过这个个功能，

51、用用户可以以将显示示内容分分组管理理，并且且可以实实现多图图层功能能、游戏戏Sprritee功能等等，使用用非常灵灵活多变变。创建建用户显显示设备备的方法法如下：HDC CCreaateDDC(iint widdth, innt hheigght);函数功能：创建一一个用户户显示设设备。参数说明：widdth用户户显示设设备的宽宽；heighht用户显显示设备备的高。返 回：若若函数调调用成功功，则返返回值为为用户显显示设备备句柄，否否则返回回0。说 明：每每次调用用后，系系统将创创建一个个设备结结构，并并且根据据设备的的大小创创建一个个新的显显示缓冲冲区内存存。释放放的时候候系统不不仅仅会会

52、释放设设备结构构，还会会查找这这个显示示缓冲区区内存是是否还有有别的显显示设备备使用，如如果没有有则释放放。用户户刚刚创创建的DDC会有有几个默默认属性性，默认认前景色色为0 xxFFFFF，默默认背景景色为00 x00000，默认透明色为0 x0101，资源数据的的复制HDC作为为显示设设备句柄柄，可以以通过以以上两种种方式创创建。另另一种创创建HDDC的方方法是复复制DCC的数据据接口，复复制后的的DC与与源DCC使用同同一显示示缓冲区区，确可可以有不不同的设设备信息息。使用用这个功功能，用用户可以以在不用用反复切切换修改改设备信信息的情情况下，用用多种方方式操作作同一个个显示缓缓冲区。H

53、DCCCopyyDC(HDCC hddc); 函数功能：复制一一个显示示设备资资源。参数说明：hdcc需要要复制的的显示设设备句柄柄； 返 回：若若函数调调用成功功，则返返回值为为新的显显示设备备句柄，否否则返回回0。说 明：源源设备和和新设备备在分别别占用系系统资源源，使用用后都需需要释放放。释放DC资资源以上的篇幅幅中，很很多地方方都在提提醒读者者注意释释放DCC资源，因因为它和和申请内内存需要要释放，打打开文件件需要关关闭一样样。下面面我们就就来介绍绍一下如如何释放放DC资资源。void ClooseHHanddle(HDCC hddc); 函数功能：释放一一个显示示设备资资源。参数说明

54、：hdcc需要要释放的的显示设设备句柄柄； 显示设备信信息每个显示设设备的结结构中都都会存储储该显示示设备的的一些基基本信息息，其中中包括坐坐标原点点、剪切切区、前前景色、背背景色、透透明色、字字体、显显示缓冲冲区地址址以及格格式、绘绘图模式式和大小小。这些些设备信信息应用用程序都都可以通通过相关关的函数数设置，其其中显示示缓冲区区地址以以及格式式还可以以通过GGetDDCInnfo获获得。高高阳虚拟拟平台提提供的显显示设备备信息的的函数接接口如下下：void SettOrgg(HDDC hhdc, innt xx, iint y); 函数功能：设置指指定显示示设备的的坐标原原点。参数说明：h

55、dcc指定定显示设设备的句句柄；x显示示设备的的x坐标标原点；y显示示设备的的y坐标标原点。void SettAreea(HHDC hdcc, iint x0, innt yy0, intt x11, iint y1);函数功能：设置指指定显示示设备的的剪切区区。参数说明：hdcc指定定显示设设备的句句柄；x0显显示设备备剪切区区的起始始x坐标标；y0显显示设备备剪切区区的起始始y坐标标；x1显显示设备备剪切区区的终止止x坐标标；y1显显示设备备剪切区区的终止止y坐标标。int SSetFFgCoolorr(HDDC hhdc, innt ccoloor);函数功能：设置显显示设备备的前景景色

56、。参数说明：hdcc指定定显示设设备的句句柄；colorr显示示设备的的前景色色值。返 回：显显示设备备以前的的前景色色值。int SSetBBgCoolorr(HDDC hhdc, innt ccoloor);函数功能：设置显显示设备备的背景景色。参数说明：hdcc指定定显示设设备的句句柄；colorr显示示设备的的背景色色值。返 回：显显示设备备以前的的背景色色值。intSSetKKeyCColoor(HHDC hdcc, iint collor);函数功能：设置显显示设备备的透明明色。参数说明：hdcc指定定显示设设备的句句柄；colorr显示示设备的的透明色色值。返 回：显显示设备备以

57、前的的透明色色值。void SettDraawMoode(HDCC hddc, eDRRAW modde);函数功能：设置显显示设备备的绘图图模式，此此处设置置的绘画画模式只只作用于于绘画及及填充基基本图形形。参数说明：hdcc指定定显示设设备的句句柄；mode显示示设备的的绘图模模式，eeDRAAW是一一个枚举举类型。DRAW_COPPY，用用前景色色去绘画画或填充充图形；DRAW_XORR，反显显绘图区区域上的的内容；DRAW_BROOKENN，用前前景色绘绘制或填填充虚线线图形。复制模式虚拟机平台台中的复复制模式式主要用用在DCC的拷贝贝及特殊殊处理上上，复制制模式有有DRAAW_CCO

58、PYY、DRRAW_XORR、DRRAW_ANDD、DRRAW_OR、DDRAWW_SPPRITTE和DDRAWW_NOOT。其其中DRRAW_COPPY只简简单的复复制，DDRAWW_XOOR是将将源数据据与目标标数据相相异或后后再赋值值给目标标，DRRAW_ANDD是将源源数据与与目标数数据相与与后再赋赋值给目目标，DDRAWW_ORR是将源源数据与与目标数数据相或或后再赋赋值给目目标、DDRAWW_SPPRITTE是只只将源数数据中的的非透明明色数据据赋值给给目标，DDRAWW_NOOT表示示先将源源数据取取反，然然后再复复制到目目标区域域中，这这个模式式可与其其它模式式组合使使用。显示

59、缓冲区区虚拟机平台台将显示示缓冲区区的信息息定义成成了一个个结构体体，并通通过函数数GettDCIInfoo将显示示缓冲区区的信息息开放给给开发者者。结构构体定义义如下：typeddef strructtvoidd *mmem;/显显示缓冲冲区地址址eBMPP BmmpTyype;/显显示格式式unsiigneed sshorrt wwidtth;/DDC的宽宽unsiigneed sshorrt hheigght;/DDC的高高unsiigneed sshorrt LLineeWiddthss;/每每个象素素行的字字节数unsiigneed sshorrt BBitssPixxel;/每每个

60、象素素点的字字节数 DCIInfoo; 函数定义为为：intGGetDDCInnfo(HDCC hddc, DCIInfoo *ddi);函数功能：获取用用户显示示设备的的显示缓缓冲区信信息。参数说明：hdcc指定定用户显显示设备备的句柄柄；di显显示设备备显示缓缓冲区信信息的结结构体地地址，用用来存储储返回的的信息。返 回：若若函数调调用成功功，则返返回值为为非0，否否则返回回0。由于虚拟机机平台的的显示设设备的显显示缓冲冲区格式式与目标标平台的的LCDD显示缓缓冲区格格式相同同，而应应用程序序如果按按照这种种固定的的格式直直接往缓缓冲区中中写数据据，将会会导致该该应用程程序的兼兼容性不不好