国产探花免费观看_亚洲丰满少妇自慰呻吟_97日韩有码在线_资源在线日韩欧美_一区二区精品毛片,辰东完美世界有声小说,欢乐颂第一季,yy玄幻小说排行榜完本

首頁 > 編程 > C++ > 正文

C++ COM編程之QueryInterface函數(一)

2020-05-23 14:21:01
字體:
來源:轉載
供稿:網友
這篇文章主要介紹了C++ COM編程之QueryInterface函數(一),QueryInterface是組件本身提供對自己查詢的一個接口,需要的朋友可以參考下
 
 

前言

組件對外公布的是接口;一個組件可以實現多個接口,也就是說可以對外公布多個接口,之前也總結過了,你很少會100%的去完全了解一個組件的所有接口,就像你去學習編程一樣,你幾乎不可能去成為編程中的全才。那么,既然我們不能去完全的了解一個組件提供的所有接口,那么我們在實際開發中,如何去判斷一個組件是否提供對應的接口呢?看文檔?是的,是個好主意,在文檔的海洋,找到一個知識點,真的很難,浪費時間和精力;其實,組件本身就提供對自己查詢的一個接口,讓客戶去詢問組件,問它是否支持某個接口,在經過多次的這種詢問之后,客戶對于組件的認識將越來越清晰;而我這篇文章和下一篇文章就是對這種詢問機制進行詳細的剖析和總結。

關于IUnknown

上面說到組件本身提供一個對自己查詢的接口,那么這個接口是什么呢?這就是大名鼎鼎的IUnknown接口了,IUnknown接口在Windows SDK的unknwn.h中定義,它的定義如下:

 

復制代碼代碼如下:

interface IUnknown
{
public:
    virtual HRESULT STDMETHODCALLTYPE QueryInterface(REFIID riid, _COM_Outptr_  void **ppvObject) = 0;
    virtual ULONG STDMETHODCALLTYPE AddRef( void) = 0;
    virtual ULONG STDMETHODCALLTYPE Release( void) = 0;
};

 

這里的STDMETHODCALLTYPE表示調用方式,也就是windows API的__stdcall方式。可以看到,在IUnknown中定義了一個名為QueryInterface的函數。客戶可以調用QueryInterface來判斷組件是否支持某個特定的接口,而對于剩下的AddRef和Release兩個接口操作,我會在之后的文章中進行總結。

所有的COM接口都需要繼承IUnknown接口;因此,如果某個客戶擁有一個IUnknown接口的指針,它并不需要知道它所擁有的接口指針到底是指向什么類型的,而只需要知道此接口可以用來查詢其它接口就行了。

由于所有的COM接口都首先繼承了IUnknown,再根據對之前的文章COM編程——接口的背后 的理解,我們可以知道每個接口的vtbl中的前三個函數都是QueryInterface,AddRef和Release。這就使得所有的COM接口都可以被當成IUnknown接口來處理。如果某個接口的vtbl中的前三個函數不是這三個,那么它將不是一個COM接口。由于所有的接口都是從IUnknown繼承而來的,因此所有的接口都支持QueryInterface。所以,組件的任何一個接口都可以被客戶用來獲取它所支持的其他接口。由于所有的接口指針同時也將是IUnknown指針,客戶并不需要單獨維護一個代表組件的指針,它所關心的將僅僅是接口的指針。

既然,我們可以只用QueryInterface去詢問組件是否支持某個接口,但是,這一切都是基于獲得了IUnknown接口指針之后,才能進行的操作,那么如何獲得一個指向組件的IUnknown接口指針呢?我們可以實現一個CreateInstance函數,它建立一個組件并返回一個IUnknown指針;對于客戶來說,可以調用CreateInstance獲得IUnknown指針,而不用使用new操作符了。在系統的總結了COM的所有基礎知識之后,我再說說系統提供的一個創建組件實例的API函數。

關于QueryInterface

IUnknown中包含一個名為QueryInterface的成員函數,客戶可以通過此函數來查詢某個組件是否支持某個特定的接口。若支持,QueryInterface將返回一個指向此接口的指針;否則返回值將是一個錯誤代碼;然后客戶可以接著查詢其它接口。

從QueryInterface函數的聲明中可以看出,QueryInterface有兩個參數,第一個參數標識客戶所需的接口,這個參數是一個接口標識符(IID)結構,在之后的文章中,我會總結有關IID的知識的;第二個參數用來存放所請求的接口的地址。QueryInterface返回的是一個HRESULT值,它是一個具有特定結構的32位值,之后我也會進行總結的;對于返回的HRESULT值,在實際開發中,需要使用SUCCEEDED宏或FAILED宏去進行判斷HRESULT值是表示成功還是失敗。

QueryInterface的簡單實現

總結了QueryInterface的簡單實現,說白了,就是簡單工廠模式的實現;上面也說了,就是根據客戶提供的IID接口標識符,然后獲得對應的接口的指針,返回對應的接口的指針;如果組件支持客戶指定的接口,那么應返回S_OK以及相應的指針;若不支持,返回值應是E_NOINTERFACE,并將相應的指針返回值置成NULL。下面通過一個簡單的例子來說明QueryInterface的簡單實現:

C++ COM編程之QueryInterface函數(一)

比如有上述的一個結構;接口IX和IY都繼承自IUnknown接口,組件CA實現了IX和IY接口,那么QueryInterface的實現應該像下面這樣:

 

復制代碼代碼如下:

HRESULT __stdcall CA::QueryInterface(const IID &iid, void **ppv)
{
     if (iid == IID_IUnknown)
     {
          *ppv = static_cast<IX *>(this);
     }
     else if (iid == IID_IX)
     {
          *ppv = static_cast<IX *>(this);
     }
     else if (iid == IID_IY)
     {
          *ppv = static_cast<IY *>(this);
     }
     else
     {
          *ppv = NULL;
          return E_NOINTERFACE;
     }
     static_cast<IUnknown *>(*ppv)->AddRef();
     return S_OK;
}

 

QueryInterface的簡單使用

當我獲得了一個IUnknown指針以后,就可以調用對應的QueryInterface進行查詢了,如下:

復制代碼代碼如下:

void Fod(IUnknown *pI)
{
     IX *pIX = NULL;
     // Ask for interface IX
     HRESULT hr = pI->QueryInterface(IID_IX, (void **)&pIX);
     // Check the return value
     if (SUCCEEDED(hr))
     {
          // Use the interface
          pIX->Fx();
     }    
}

 

完整的例子

上面說了那么多了,現在提供一個完整的例子,將上面的各種理論知識都在實際代碼中進行了實踐,讓各位能更好的理解QueryInterface。(下載)。

總結

QueryInterface理解起來比較簡單,但是,它的理論知識還是必須要去掌握的,理論是一切的基礎,沒有理論作為支撐,任何實際的操作都不會那么可靠和可信,所以,這篇文章總結的偏于理論多一些。由于QueryInterface部分的內容比較多,使用一篇文章無法總結的齊全,所以,之后我還會繼續總結關于QueryInterface的第二部分。


發表評論 共有條評論
用戶名: 密碼:
驗證碼: 匿名發表
主站蜘蛛池模板: 武功县| 平罗县| 蒙阴县| 教育| 塔河县| 凤山市| 阜新市| 平罗县| 静安区| 石阡县| 浠水县| 太白县| 五台县| 许昌市| 米脂县| 邳州市| 烟台市| 曲靖市| 布尔津县| 资溪县| 文昌市| 聂拉木县| 广西| 大英县| 佛山市| 南安市| 晋江市| 黎城县| 邳州市| 乌鲁木齐市| 商南县| 平顶山市| 商城县| 朝阳区| 巴马| 青浦区| 揭阳市| 徐水县| 赣州市| 师宗县| 宾川县|