七.建立DIRECTDRAW对象 象我前面说过的，有三种方法。我们可以用两个DIRECTDRAW函数中的任何一个，或者直接调用COM对象。让我们每一个都试试，使我们自己熟悉它们。我将告诉你的最后一个方法可能是目前为止最简单的，可能你会喜欢用它。至于另外两个，打眼儿一看，你会觉得有些希奇。首先，看看DirectDrawCreate（）： HRESULT WINAPI DirectDrawCreate( GUID FAR *lpGUID, LPDIRECTDRAW FAR *lplpDD, IUnknown FAR *pUnkOuter ); 看起来是不是有点儿复杂？HRESULT返回的类型是DirectDraw函数的标准。假如成功，返回值是DD_OK。假如失败，函数将返回一个错误常量，有几个错误常量供选择，但我不想细讲，更不想列出这些常量，反正你可以通过帮助文件随时查阅它们。但有一件事儿我得告诉你，有两个非常有用的宏可以帮助你知道函数调用成功与否：SUCCEEDED()和FAILED()。从字面上你就知道它们的分工了，是不是？只要把函数放到宏里面，你就知道结果了。无论如何，我们还得看看函数的参数： · GUID FAR *lpGUID：是一个全局唯一标识符（GUID）的地址，代表将要创建的驱动程序。假如该参数是NULL，那么该调用指向当前的显示驱动程序。新版本的DirectDraw答应向该参数传递下列两种标志之一，以控制当前显示的行为： DDCREATE_EMULATIONONLY：DirectDraw只使用仿真（HEL），不使用硬件支持特性。 DDCREATE_HARDWAREONLY：DirectDraw对象不使用仿真特性。只能使用硬件抽象层（HAL），假如硬件不能支持应用程序，将不再寻求硬件仿真层（HEL）的支持而返回错误信号。 · LPDIRECTDRAW FAR *lplpDD：表示假如调用成功则返回有效的DirectDraw对象指针的地址，它是DirectDraw对象指针的指针（“DD”表示DirectDraw，“lp”表示32位长指针，“lplp”表示长指针的长指针）。应用程序一般需要使用此指针的地址（即DirectDraw对象指针）初始化DirectDraw对象。 · IUnknown FAR *pUnkOuter：这是为高级COM应用保留的参数，设置为NULL好了。 不要被我罗里罗嗦的解释吓倒，实际应用起来很简单，解释这么多，不过是为了让你明白根本道理。现在有一个问题，这个函数给你一个指向IDirectDraw接口的指针，但我们想要一个指向IDirectDraw7接口的指针，我们应该怎么做呢？一旦DirectDraw应用程序通过DirectDrawCreate（）函数获得了指向DirectDraw对象的指针，COM就有一种机制可以用来查看该对象是否支持其它接口。IUnknown的QueryInterface()方法使得你能够确定一个对象是否支持一个特定的接口： HRESULT QueryInterface( REFIID iid, // Identifier of the requested interface void **ppvObject // Address of output variable that receives the ); 第一个参数是一个要查询的对象的引用标识符。对于IDirectDraw7来说就是IID_IDirectDraw7。使用它，你必须把dxguid.lib链接入你的项目中；第二个参数是一个变量的地址，我们应该在程序的头部先声明一个LPDIRECTDRAW7类型的指针，再把指针的地址传递给这个参数。假如你使用的是Visual C＋＋6.0，你在这儿或许还需要一个类型强制符。假如机器支持你指定的接口，函数将返回一个指向该接口的指针。通过该指针，代码就获得对新接口的方法的访问。假如函数调用成功，返回值是S_OK。 现在我们有了两个接口指针：一个是IDirectDraw接口，另一个是IDirectDraw7。后一个是我们想要的；前一个就没有用了。我们注重，在代码中每当找到一个新的有效对象时，前一个对象就通过Release()函数被释放掉。这个函数很简单：ULONG Release(void); 返回的值是一个参考数字，只有在程序测试和调试时才用得着这个数字。为了安全起见，你还应该把释放了的指针赋值为NULL。我们也通常在声明这样的指针时设置它为NULL。你跟上我的节奏了吗？可能要记忆的东西太多了，但是你不得不记忆。让我们把谈到的这些做个实例吧，实例的目的是得到IDirectDraw7接口的指针：LPDIRECTDRAW lpdd = NULL; // pointer to IDirectDraw (temporary) LPDIRECTDRAW7 lpdd7 = NULL; // pointer to IDirectDraw7 (what we want)// get the IDirectDraw interface pointer if (FAILED(DirectDrawCreate(NULL, &lpdd, NULL))) { // error-handling code here }// query for IDirectDraw7 pointer if (FAILED(lpdd->QueryInterface(IID_IDirectDraw7, (void**)&lpdd7))) { // error-handling code here } else { // success! release IDirectDraw since we don t need it anymore
lpdd->Release(); lpdd = NULL; } 现在，假如你是一个C程序员，你可能被调用QueryInterface()和Release()这两个函数的方法弄得有点模糊。你以前可能看过“->”这个符号，在C语言的结构部分，当结构声明了一个指针变量，调用结构成员时，就用“结构指针名－>结构成员”，同样的道理，只是这里把结构成员换成了函数。既然说到这个话题，我就介绍一下另一个C＋＋符号，范围定义符号“：：”，它是表示从属关系的符号，举个例子你就明白了：比如QueryInterface()函数是属于IUnknown类的，就可以表示为IUnknown::QueryInterface()。我们将来会经常用到这个符号的，所以记住它。 说实在的，以上的主要目的是为了演示怎样使用QueryInterface()方法，它是所有DirectX接口的一部分，所以让我们往下进行。我们将直接使用COM方法获得接口指针。这种方法的好处是你可以立即获得IDirectDraw7接口指针，不用象刚才那么麻烦。首先，你必须得初始化COM，象这样：HRESULT CoInitialize(LPVOID pvReserved); 不能在轻易了，你必须把参数设置为NULL。当你结束COM调用，你需要抛弃它，也很简单：void CoUninitialize(void); 我通常在DirecX程序的一开始就调用CoInitialize()函数，在程序的最末端，当我释放了所有的DirectX对象后，使用CoUninitialize()。一旦你初始化了COM，你就可以用CoCreateInterface()函数得到你想要的指针，它看起来有点丑陋：STDAPI CoCreateInstance( REFCLSID rclsid, // Class identifier (CLSID) of the object LPUNKNOWN pUnkOuter, // Pointer to whether object is or isn t part // of an aggregate DWord dwClsContext, // Context for running executable code REFIID riid, // Reference to the identifier of the interface LPVOID *ppv // Address of output variable that receives ); // the interface pointer requested in riid 假如成功，返回值是S_OK。参数需要好好解释一下，看下面： · REFCLSID rclsid：这是一个类标识符（不要同GUID搞混了哦），有为它预备好的常量标识符供你选择。对于IDirectDraw7来说，使用CLSID_DirectDraw。注重没有版本号，因为它是类标识符，不是接口标识符。 · LPUNKNOWN pUnkOuter：这个同我们在DirectDrawCreate()中看到的一样，设置为NULL。 · DWORD dwClsContext：这个必需的值叫作执行上下文，它定义了控制新生成对象的代码将要执行的方式。这个值可以从CLSCTX列表中选取，对于我们现在的情况，我们用CLSCTX_ALL，它包含了所有可能的值。 · REIID riid：我们在QueryInterface()中看过它。这个IID是IID_DirectDraw7。 · LPVOID *ppv：依然同DirectDrawCreate()中的一样，是指向接口指针的地址。 调用这个函数将取代我们上一个方法中的DirectDrawCreate()、QueryInterface()和Release（）三个函数，所以简捷一些。当然，使用哪种随便你了。直接调用COM比我们先前用的方法少了一个多于地接口指针。一旦你用CoCreateInstance（）建立了一个对象，你还得调用Initialize()函数初始化这个对象。在C＋＋里可能写成这样IDirectDraw7::Initialize()。以下是它的原形：HRESULT Initialize(GUID FAR *lpGUID); 将使用同DirectDrawCreate()中一样的GUID，就是NULL。在我们继续前，让我给你看一个使用COM创建DirectDraw对象的例子：LPDIRECTDRAW7 lpdd7; // interface pointer// initialize COM CoInitialize(NULL);// create the object CoCreateInstance(CLSID_DirectDraw, NULL, CLSCTX_ALL, IID_IDirectDraw7, (void**)&lpdd7);// initialize the object lpdd7->Initialize(NULL); 直接看例子可能使你更轻易理解一些。好了，建立DirectDraw对象的最难的两种方法你已经学会了，那就让我们看看最简单的方法吧！ 它只有一步，没有多于的接口指针，不用设置COM，什么都没有。就是下面这个函数：DirectDrawCreateEx( GUID FAR *lpGuid, LPVOID *lplpDD, REFIID iid, IUnknown FAR *pUnkOuter ); 所有的参数我们看起来都比较熟悉，因为我们刚才看过它们了。第一个，第二个和第四个参数同DirectDrawCreate()中的一样，只是这里需要用(void**)来修饰一下我们接口指针的地址——别问我为什么，这不是我的主意。第三个参数，riid，是我们在函数CoCreateInstance()中传递的接口ID，所以我们就用IID_IDirectDraw7。就这样，无论用哪种方法，我们得到了我们的DirectDraw对象，我们可以继续使用这个对象了。要做的头两件事是设置协作等级和显示协议。 八.作等级和显示模式 我不需要说太多。Windows编程设置协作级别你只需要调用IDirectDraw7::SetCoOperativeLevel()函数；设置显示模式你就调用IDirectDraw7::SetDisplayMode()函数。就这么简单！先来看看协作级别。这就是函数原形：
