【转摘】DirectDraw接口函数详解
1.关于DirectDraw API
衡量API的一个方法就是看它的大小。一个庞大复杂的API可能就是计划不周的结果。另一方面，一个庞大的API有时就意味着每一种情况都有可能出现。一个小的API就是一个新的、缺乏功能的软件包的证据。它也意味着，一个API只能做它所需要做的，而不能多做一点。
DirectDraw API是比较小的，因此本章中所讨论的每一个函数不致于使本章看起来像一本参考手册。DirectDraw提供很少的方便，也很少有限制。
DirectDraw由个COM对象构成，每个对象可以通过一个或多个接口存取。这些接口包括：
●DirectDraw
●DirectDraw2
●DirectDrawSurface
●DirectDrawSurface2
●DirectDrawSurface3
●DirectDrawPalette
●DirectDrawClipper
我们将讨论每一个接口，并随后讨论它们的成员函数。但我们并不讨论每个函数的细节，因为我们并不是向您提供一份参考手册。相反，我们将讨论每个函数是干什么的，为什么这样使用，以及你有可能如何去使用它。
当DirectX首次推出的时候(早先它被称作Games SDK)，DirectDraw核心函数性以DirectDraw接口表示。当DirectX2推出的时候，DirectDraw也已经
被升级了。DirectDraw遵守COM规格而未被改变。新的函数性可能通过DirectDraw2接口存取。
特别要注意的是，DirectDraw2接口是DirectDraw接口的超级设置。DirectDraw2接口可提供DirectDraw接口的所有函数，另外还增加了一些新的函数。如果你正在使用DirectX或更高版高，那么你可以随意选用DirectDraw 接口或DirectDraw2接口。但是，由于DirectDraw2接口较DirectDraw接口的功能更强，所以没有必要使用DirectDraw接口。同样，Microsoft并不主张使用这些无组织的、网络可变的接口。因此，在本书以后的程序中我们只使用DirectDraw2接口。
DirectDraw和DirectDraw2接口提供的成员函数如下(按字母顺序排列)：
●Compact()
●CreateClipper()
●CreatePalette()
●CreateSurface()
●DuplicateSurface()
●EnumDisplayModes()
●EnumSurfaces()
●FlipToGDISurface()
●GetAvailableVidMem()
●GetCaps()
●GetDisplayMode()
●GetFourCCCodes()
●GetGDISurface()
api接口和sdk接口的区别●GetMonitorFrequency()
●GetScanline()
●GetVerticalBlankStatus()
●RestoreDisplayMode()
●SetCooperativeLevel()
●SetDisplayMode()
●WaitForVerticalBlank()
接下来我们讨论DirectDraw接口函数。注意，在本章以后的内容中，DirectDraw接口既表示DirectDraw接口，也表示DirectDraw2接口。只有在
区分DirectDraw接口和DirectDraw2接口的函数时，才加以区别。
1.接口创建函数
DirectDraw接口表示DirectDraw本身。该接口在被用于创建其他DirectDraw接口实例时，是一个主接口。DirectDraw接口提供三个这样的接口实例创建函数：
●CreateClipper()
●CreatePalette()
●CreateSurface()
CreateClipper()函数用于创建DirectDrawClipper接口实例。并非所有的DirectDraw应用程序都用到剪裁器，所以该函数并不是在所有的程序中都出现。我们将很快讨论DirectDrawClipper的细节。
CreatePalette()函数用于创建DirectDrawPalette接口实例。同DirectDrawClipper一样，并非所有的DirectDraw应用程序都用到调板。比如，应用程序使用16位显示模式时，就不用调板。但是，当应用程序使用8位显示模式时，就必须创建至少一个DirectDrawPalette实例。
CreateSurface()函数用于创建DirectDrawSurface接口实例。任何一个DirectDraw应用程序都要用表面来生成图像数据，因此经常要用到这一函数。
DirectDraw接口自己的实例是由DirectDrawCreate()函数创建的。DirectDrawCreate()是DirectDraw函数中少有的几个常规函数之一，但并不是COM接口成员函数。
2.GetCaps()函数
DirectDraw接口允许准确确定软硬件都支持的特征。GetCaps()函数可以对两个DDCAP结构实例进行初始化。一个结构表明哪些特征由显示硬件直接支持，另一个结构表明哪些特征由软件仿真支持。最好是用GetCaps()函数来决定你将用到的特征是否被支持。
提示：DirectX浏览器
DirectX SKD是与DXVIEW程序同时推出的。DXVIEW说明了DirectX组件的功能，包括DirectDraw。大多数系统中，有两个DirectDraw项目：主显示驱动器和硬件仿真层。第一项说明了显示硬件的功能。第二项说明了在缺乏硬件支持的情况下，DirectDraw将要仿真的一些特征。在具有两个以上的DirectDraw支持的显示卡的计算机中，DXVIEW会显示卡的功能。
3.SetCooperativeLevel()函数
SetCooperativeLevel()函数用于指定应用程序所要求的对显示硬件的控制程度。比如，一个正常合作度意味着应用程序既改变不了当前显示模式，也不能指定整个系统调板的内容。而一个专有的合作度允许显示模式切换，并能完全控制调板。不管你决定使用哪种合作度，都必须调用SetCooperativeLevel()函数。
4.显示模式函数
DirectDraw接口提供4种显示模式操作函数。它们是：
●EnumDisplayModes()
●GetDisplayMode()
●RestoreDisplayMode()
●SetDisplayMode()
EnumDisplayModes()函数可用于查询DirectDraw使用何种显示模式。通过设置EnumDisplayModes()函数默认值可以得到所有的显示模式，而且可以通过显示模式描述消除那些不感兴趣的模式。进行显示模式切换的过程中最好使用EnumDisplayModes()函数。现在市场上有各种各样的显示设备，每种显示设
备都有自己的特征和局限。除了默认的640×480×8窗口显示模式，最好不要依靠任何给定的显示模式的支持。
GetDisplayMode()函数可以检索到有关当前显示模式的信息，并在DDSURFACEDESC结构实例中显示当前显示模式的宽度、高度、像素深度以及像素格式等信息。还有别的途径可以检索到同样的信息(比如检索主表面描述)，因此该函数并不出现在所有的程序中。
SetDisplayMode()函数用于激活所支持的显示模式。SetDisplayMode()函数的DirectDraw2版本还允许设定显示模式的刷新率。而DirectDraw接口版本的SetDisplayMode()函数只能进行显示模式宽度、高度和像素深度的设置。任何一个要进行显示模式切换的程序都要用到SetDisplayMode()函数。
RestoreDisplayMode()函数用于存储调用SetDisplayMode()函数之前的显示模式。SetDisplayMode()和RestoreDisplayMode()函数都要求优先使用SetCooperativeLevel()函数得到的专有合作存取。
5.表面支持函数

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。