七.建立DIRECTDRAW對象 象我前面說過的，有三種方法。我們可以用兩個DIRECTDRAW函數(shù)中的任何一個，或者直接調用COM對象。讓我們每一個都試試，使我們自己熟悉它們。我將告訴你的最后一個方法可能是目前為止最簡單的，可能你會喜歡用它。至于另外兩個，打眼兒一看，你會覺得有些希奇。首先，看看DirectDrawCreate（）： HRESULT WINAPI DirectDrawCreate( GUID FAR *lpGUID, LPDIRECTDRAW FAR *lplpDD, IUnknown FAR *pUnkOuter ); 看起來是不是有點兒復雜？HRESULT返回的類型是DirectDraw函數(shù)的標準。假如成功，返回值是DD_OK。假如失敗，函數(shù)將返回一個錯誤常量，有幾個錯誤常量供選擇，但我不想細講，更不想列出這些常量，反正你可以通過幫助文件隨時查閱它們。但有一件事兒我得告訴你，有兩個非常有用的宏可以幫助你知道函數(shù)調用成功與否：SUCCEEDED()和FAILED()。從字面上你就知道它們的分工了，是不是？只要把函數(shù)放到宏里面，你就知道結果了。無論如何，我們還得看看函數(shù)的參數(shù)： · GUID FAR *lpGUID：是一個全局唯一標識符（GUID）的地址，代表將要創(chuàng)建的驅動程序。假如該參數(shù)是NULL，那么該調用指向當前的顯示驅動程序。新版本的DirectDraw答應向該參數(shù)傳遞下列兩種標志之一，以控制當前顯示的行為： DDCREATE_EMULATIONONLY：DirectDraw只使用仿真（HEL），不使用硬件支持特性。 DDCREATE_HARDWAREONLY：DirectDraw對象不使用仿真特性。只能使用硬件抽象層（HAL），假如硬件不能支持應用程序，將不再尋求硬件仿真層（HEL）的支持而返回錯誤信號。 · LPDIRECTDRAW FAR *lplpDD：表示假如調用成功則返回有效的DirectDraw對象指針的地址，它是DirectDraw對象指針的指針（“DD”表示DirectDraw，“l(fā)p”表示32位長指針，“l(fā)plp”表示長指針的長指針）。應用程序一般需要使用此指針的地址（即DirectDraw對象指針）初始化DirectDraw對象。 · IUnknown FAR *pUnkOuter：這是為高級COM應用保留的參數(shù)，設置為NULL好了。 不要被我羅里羅嗦的解釋嚇倒，實際應用起來很簡單，解釋這么多，不過是為了讓你明白根本道理。現(xiàn)在有一個問題，這個函數(shù)給你一個指向IDirectDraw接口的指針，但我們想要一個指向IDirectDraw7接口的指針，我們應該怎么做呢？一旦DirectDraw應用程序通過DirectDrawCreate（）函數(shù)獲得了指向DirectDraw對象的指針，COM就有一種機制可以用來查看該對象是否支持其它接口。IUnknown的QueryInterface()方法使得你能夠確定一個對象是否支持一個特定的接口： HRESULT QueryInterface( REFIID iid, // Identifier of the requested interface void **ppvObject // Address of output variable that receives the ); 第一個參數(shù)是一個要查詢的對象的引用標識符。對于IDirectDraw7來說就是IID_IDirectDraw7。使用它，你必須把dxguid.lib鏈接入你的項目中；第二個參數(shù)是一個變量的地址，我們應該在程序的頭部先聲明一個LPDIRECTDRAW7類型的指針，再把指針的地址傳遞給這個參數(shù)。假如你使用的是Visual C＋＋6.0，你在這兒或許還需要一個類型強制符。假如機器支持你指定的接口，函數(shù)將返回一個指向該接口的指針。通過該指針，代碼就獲得對新接口的方法的訪問。假如函數(shù)調用成功，返回值是S_OK。 現(xiàn)在我們有了兩個接口指針：一個是IDirectDraw接口，另一個是IDirectDraw7。后一個是我們想要的；前一個就沒有用了。我們注重，在代碼中每當找到一個新的有效對象時，前一個對象就通過Release()函數(shù)被釋放掉。這個函數(shù)很簡單：ULONG Release(void); 返回的值是一個參考數(shù)字，只有在程序測試和調試時才用得著這個數(shù)字。為了安全起見，你還應該把釋放了的指針賦值為NULL。我們也通常在聲明這樣的指針時設置它為NULL。你跟上我的節(jié)奏了嗎？可能要記憶的東西太多了，但是你不得不記憶。讓我們把談到的這些做個實例吧，實例的目的是得到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; } 現(xiàn)在，假如你是一個C程序員，你可能被調用QueryInterface()和Release()這兩個函數(shù)的方法弄得有點模糊。你以前可能看過“->”這個符號，在C語言的結構部分，當結構聲明了一個指針變量，調用結構成員時，就用“結構指針名－>結構成員”，同樣的道理，只是這里把結構成員換成了函數(shù)。既然說到這個話題，我就介紹一下另一個C＋＋符號，范圍定義符號“：：”，它是表示從屬關系的符號，舉個例子你就明白了：比如QueryInterface()函數(shù)是屬于IUnknown類的，就可以表示為IUnknown::QueryInterface()。我們將來會經(jīng)常用到這個符號的，所以記住它。 說實在的，以上的主要目的是為了演示怎樣使用QueryInterface()方法，它是所有DirectX接口的一部分，所以讓我們往下進行。我們將直接使用COM方法獲得接口指針。這種方法的好處是你可以立即獲得IDirectDraw7接口指針，不用象剛才那么麻煩。首先，你必須得初始化COM，象這樣：HRESULT CoInitialize(LPVOID pvReserved); 不能在輕易了，你必須把參數(shù)設置為NULL。當你結束COM調用，你需要拋棄它，也很簡單：void CoUninitialize(void); 我通常在DirecX程序的一開始就調用CoInitialize()函數(shù)，在程序的最末端，當我釋放了所有的DirectX對象后，使用CoUninitialize()。一旦你初始化了COM，你就可以用CoCreateInterface()函數(shù)得到你想要的指針，它看起來有點丑陋：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。參數(shù)需要好好解釋一下，看下面： · REFCLSID rclsid：這是一個類標識符（不要同GUID搞混了哦），有為它預備好的常量標識符供你選擇。對于IDirectDraw7來說，使用CLSID_DirectDraw。注重沒有版本號，因為它是類標識符，不是接口標識符。 · LPUNKNOWN pUnkOuter：這個同我們在DirectDrawCreate()中看到的一樣，設置為NULL。 · DWORD dwClsContext：這個必需的值叫作執(zhí)行上下文，它定義了控制新生成對象的代碼將要執(zhí)行的方式。這個值可以從CLSCTX列表中選取，對于我們現(xiàn)在的情況，我們用CLSCTX_ALL，它包含了所有可能的值。 · REIID riid：我們在QueryInterface()中看過它。這個IID是IID_DirectDraw7。 · LPVOID *ppv：依然同DirectDrawCreate()中的一樣，是指向接口指針的地址。 調用這個函數(shù)將取代我們上一個方法中的DirectDrawCreate()、QueryInterface()和Release（）三個函數(shù)，所以簡捷一些。當然，使用哪種隨便你了。直接調用COM比我們先前用的方法少了一個多于地接口指針。一旦你用CoCreateInstance（）建立了一個對象，你還得調用Initialize()函數(shù)初始化這個對象。在C＋＋里可能寫成這樣IDirectDraw7::Initialize()。以下是它的原形：HRESULT Initialize(GUID FAR *lpGUID); 將使用同DirectDrawCreate()中一樣的GUID，就是NULL。在我們繼續(xù)前，讓我給你看一個使用COM創(chuàng)建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對象的最難的兩種方法你已經(jīng)學會了，那就讓我們看看最簡單的方法吧！ 它只有一步，沒有多于的接口指針，不用設置COM，什么都沒有。就是下面這個函數(shù)：DirectDrawCreateEx( GUID FAR *lpGuid, LPVOID *lplpDD, REFIID iid, IUnknown FAR *pUnkOuter ); 所有的參數(shù)我們看起來都比較熟悉，因為我們剛才看過它們了。第一個，第二個和第四個參數(shù)同DirectDrawCreate()中的一樣，只是這里需要用(void**)來修飾一下我們接口指針的地址——別問我為什么，這不是我的主意。第三個參數(shù)，riid，是我們在函數(shù)CoCreateInstance()中傳遞的接口ID，所以我們就用IID_IDirectDraw7。就這樣，無論用哪種方法，我們得到了我們的DirectDraw對象，我們可以繼續(xù)使用這個對象了。要做的頭兩件事是設置協(xié)作等級和顯示協(xié)議。 八.作等級和顯示模式 我不需要說太多。Windows編程設置協(xié)作級別你只需要調用IDirectDraw7::SetCoOperativeLevel()函數(shù)；設置顯示模式你就調用IDirectDraw7::SetDisplayMode()函數(shù)。就這么簡單！先來看看協(xié)作級別。這就是函數(shù)原形：
