开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 通讯/手机编程 > Symbian > 查看源码
unkimp.h
资源名称：helix.src.0812.rar　[点击查看]
上传用户：zhongxx05
上传日期：2007-06-06
资源大小：33641k
文件大小：23k
源码类别：

Symbian

开发平台：

C/C++

unkimp.h：源码内容
  1. /* ***** BEGIN LICENSE BLOCK ***** 
  2.  * Version: RCSL 1.0/RPSL 1.0 
  3.  *  
  4.  * Portions Copyright (c) 1995-2002 RealNetworks, Inc. All Rights Reserved. 
  5.  *      
  6.  * The contents of this file, and the files included with this file, are 
  7.  * subject to the current version of the RealNetworks Public Source License 
  8.  * Version 1.0 (the "RPSL") available at 
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed 
  10.  * the file under the RealNetworks Community Source License Version 1.0 
  11.  * (the "RCSL") available at http://www.helixcommunity.org/content/rcsl, 
  12.  * in which case the RCSL will apply. You may also obtain the license terms 
  13.  * directly from RealNetworks.  You may not use this file except in 
  14.  * compliance with the RPSL or, if you have a valid RCSL with RealNetworks 
  15.  * applicable to this file, the RCSL.  Please see the applicable RPSL or 
  16.  * RCSL for the rights, obligations and limitations governing use of the 
  17.  * contents of the file.  
  18.  *  
  19.  * This file is part of the Helix DNA Technology. RealNetworks is the 
  20.  * developer of the Original Code and owns the copyrights in the portions 
  21.  * it created. 
  22.  *  
  23.  * This file, and the files included with this file, is distributed and made 
  24.  * available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 
  25.  * EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS ALL SUCH WARRANTIES, 
  26.  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS 
  27.  * FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 
  28.  * 
  29.  * Technology Compatibility Kit Test Suite(s) Location: 
  30.  *    http://www.helixcommunity.org/content/tck 
  31.  * 
  32.  * Contributor(s): 
  33.  *  
  34.  * ***** END LICENSE BLOCK ***** */ 
  36. //
  37. //
  38. // Macro implementation of IUnknown
  39. //
  40. //  Description:
  41. // This file defines classes and Macro's to simplify the implementation 
  42. // of IUnknown in RMA objects.
  43. // It also implements object creation methods 
  44. // (CreateObject, CreateInstance)
  45. //
  46. //  Usage Tips:
  47. //
  48. // Never use the new operator to create a class instance!!
  49. //     Instead use CreateObject if you need to use non-interface
  50. //     methods and CreateInstance otherwise.
  51. //
  52. //  Class(es) Defined in this file:
  53. //
  54. // CUnknownIMP
  55. //     The COM Object implementation must inherit from this class.
  56. //
  57. // CAggregateImpl
  58. //     Used internally to support Aggregation.
  59. //
  60. //  Macros Defined in this file:
  61. //
  62. // DECLARE_UNKNOWN(THIS_CLASS)
  63. //     This must be in the class declaration.
  64. //
  65. // BEGIN_INTERFACE_LIST(THIS_CLASS)
  66. //     This must be in the class implementation.
  67. //
  68. // END_INTERFACE_LIST
  69. //     This must be in the class implementation.
  70. //
  71. // INTERFACE_LIST_ENTRY(INTERFACE_IID, INTERFACE_CLASS)
  72. //     Defines the QI of a locally implemented interface.
  73. //     Optional: if used must be in the class implementation.
  74. //
  75. // INTERFACE_LIST_ENTRY2(DERIVED_CLASS, BASE_INTERFACE_IID, BASE_CLASS)
  76. //     Defines the QI of a locally implemented interface that must be 
  77. //     disambiguated. DERIVED_CLASS is the intermediate class used to 
  78. //     achieve the disambiguation.
  79. //
  80. // INTERFACE_LIST_ENTRY_DELEGATE(INTERFACE_IID, DELEGATE_QI_FUNCTION)
  81. //     Defines the QI of a single interface supported by an aggregated 
  82. //     object.
  83. //     Optional: if used must be in the class implementation.
  84. //
  85. // INTERFACE_LIST_ENTRY_DELEGATE_BLIND(DELEGATE_QI_FUNCTION)
  86. //     Defines the QI of all interfaces supported by an aggregated object.
  87. //     Optional: if used must be in the class implementation.
  88. //
  89. // INTERFACE_LIST_ENTRY_BASE
  90. //     Specifies a base class whose query interface function should be called.
  91. //
  92. //  Example:
  93. //
  94. //  rmabuffer.h
  95. // #include <unkimp.h>
  96. //
  97. // class CHXBuffer 
  98. //     : public CUnknownIMP
  99. //     , public IHXBuffer
  100. // {
  101. //     DECLARE_UNKNOWN(CHXBuffer)
  102. // public:
  103. //     STDMETHOD(FinalConstruct)();
  104. //     void FinalRelease();
  105. //
  106. //     // List of IHXBuffer Methods..
  107. //
  108. // private:
  109. //     // List of private members..
  110. //     DECLARE_SMART_POINTER_UNKNOWN m_spunkOther;
  111. //     DECLARE_SMART_POINTER_UNKNOWN m_spunkYetAnother;
  112. // };
  113. //
  114. //  rmabuffer.cpp
  115. // #include "rmabuffer.h"
  116. //
  117. // BEGIN_INTERFACE_LIST(CHXBuffer)
  118. //     INTERFACE_LIST_ENTRY(IID_IHXBuffer, IHXBuffer)
  119. //     INTERFACE_LIST_ENTRY_DELEGATE
  120. //     (
  121. // IID_IHXOther, 
  122. // m_spunkOther.QueryInterface
  123. //     )
  124. //     INTERFACE_LIST_ENTRY_DELEGATE_BLIND
  125. //     (
  126. // m_spunkYetAnother.QueryInterface
  127. //     )
  128. // END_INTERFACE_LIST
  129. //
  130. // STDMETHODIMP CHXBuffer::FinalConstruct()
  131. // {
  132. //     // Create the Aggregated objects here..
  133. //     //
  134. //     if 
  135. //     (
  136. // SUCCEEDED
  137. // (
  138. //     CIHXOther::CreateInstance
  139. //     (
  140. // GetControllingUnknown(),
  141. // &m_spunkOther
  142. //     )
  143. // )
  144. // &&
  145. // SUCCEEDED
  146. // (
  147. //     CIHXYetAnother::CreateInstance
  148. //     (
  149. // GetControllingUnknown(),
  150. // &m_spunkYetAnother
  151. //     )
  152. // )
  153. //     )
  154. //     {
  155. // return HXR_OK;
  156. //     }
  157. //     return HXR_FAIL;
  158. // }
  159. //
  160. // void CHXBuffer::FinalRelease()
  161. // {
  162. //     // If we were not using SmartPointers, we would 
  163. //     // release the Aggregated objects here.
  164. // }
  165. //
  166. // // Implement IHXBuffer methods..
  167. //  
  170. #ifndef __CUnknownIMP_H__
  171. #define __CUnknownIMP_H__
  173. #include "hxcom.h"
  174. #include "hxassert.h"
  176. #ifdef INCLUDE_DEBUG_LIFETIME
  177. #include <io.h>
  178. #include <fcntl.h>
  179. #include "chxdataf.h"
  180. #include "hxtrace.h"
  181. #include "hxstring.h"
  182. #endif // INCLUDE_DEBUG_LIFETIME
  184. #ifdef ENABLE_UNKIMP_TRACKER
  185. #include "ihxiunknowntracker.h"
  186. #endif
  188. class CUnknownIMP : public IUnknown
  189. {
  190. public:
  191.     CUnknownIMP() : m_lCount(0), m_punkOuter(NULL)
  192. #ifdef INCLUDE_DEBUG_LIFETIME
  193.     ,m_pRaFileDebugLifetime(NULL)
  194. #endif
  196.     {
  197. m_punkControlling = this;
  198.     }
  199.     virtual ~CUnknownIMP()
  200.     {}
  202.     /*
  203.      * IUnknown methods
  204.      */
  205.     STDMETHOD(QueryInterface)
  206.     (
  207. THIS_
  208. REFIID riid,
  209. void** ppvObj
  210.     )
  211.     {
  212. if(m_punkOuter)
  213. {
  214.     return m_punkOuter->QueryInterface(riid, ppvObj);
  215. }
  216. return _ActualQI(riid, ppvObj);
  217.     }
  219.     STDMETHOD_(ULONG32,AddRef) (THIS)
  220.     {
  221. if(m_punkOuter)
  222. {
  223.     return m_punkOuter->AddRef();
  224. }
  225. return ActualAddRef();
  226.     }
  228.     STDMETHOD_(ULONG32,Release) (THIS)
  229.     {
  230. if(m_punkOuter)
  231. {
  232.     return m_punkOuter->Release();
  233. }
  234. return ActualRelease();
  235.     }
  237.     const IUnknown* GetUnknown() const
  238.     {
  239. return this;
  240.     }
  242.     IUnknown* GetUnknown()
  243.     {
  244. return this;
  245.     }
  246.     IUnknown* GetControllingUnknown()
  247.     {
  248. return m_punkControlling;
  249.     }
  251.     STDMETHOD(SetupAggregation)( IUnknown* pvOuterObj, IUnknown** pvResult );
  252.     
  253. #ifdef ENABLE_UNKIMP_TRACKER
  254.     static void SetIUnknownTracker( IHXIUnknownTracker* pIUnknownTracker )
  255.     {
  256. if (pIUnknownTracker != ms_pIUnknownTracker)
  257. {
  258.     if (ms_pIUnknownTracker)
  259.     {
  260. IHXIUnknownTracker* pIOldUnknownTracker = ms_pIUnknownTracker;
  261. ms_pIUnknownTracker = NULL;
  262. HX_RELEASE(pIOldUnknownTracker);
  263.     }
  264.     if (pIUnknownTracker)
  265.     {
  266. pIUnknownTracker->AddRef();
  267. ms_pIUnknownTracker = pIUnknownTracker;
  268.     }
  269. }
  270.     }
  271. #endif
  273. protected:
  274.     // This is overriden in the derived object to provide
  275.     // an object specific imp.
  276.     STDMETHOD(_ActualQI)(REFIID riid, void** ppvObj) PURE;
  278. #ifdef INCLUDE_DEBUG_LIFETIME
  280.     CHXDataFile* m_pRaFileDebugLifetime;
  281.     CHXString m_StringFilename;
  283.     void InitFilename(const char* pFilename)
  284.     {
  285. m_StringFilename = pFilename;
  286.     }
  288.     STDMETHOD_(ULONG32,ActualAddRef) ()
  289.     {
  290. if (m_pRaFileDebugLifetime)
  291. {
  292.     char buf[80]; /* Flawfinder: ignore */
  293.     sprintf(buf, "*** AddRef %d ***rn", m_lCount+1); /* Flawfinder: ignore */
  294.     m_pRaFileDebugLifetime->Write(buf, strlen(buf));
  295.     UINT32* pBinaryStackTrace = NULL;
  296.     if (GetStack(&pBinaryStackTrace))
  297.     {
  298. char* pCharStackTrace = NULL;
  299. if (GetStackSymbols(pBinaryStackTrace, &pCharStackTrace))
  300. {
  301.     m_pRaFileDebugLifetime->Write
  302.     (
  303. pCharStackTrace,
  304. strlen(pCharStackTrace)
  305.     );
  306. }
  307. HX_VECTOR_DELETE(pCharStackTrace);
  308.     }
  309.     HX_VECTOR_DELETE(pBinaryStackTrace);
  310. }
  312. return InterlockedIncrement(&m_lCount);
  313.     }
  314.     STDMETHOD_(ULONG32,ActualRelease) ()
  315.     {
  316. if (m_pRaFileDebugLifetime)
  317. {
  318.     char buf[80]; /* Flawfinder: ignore */
  319.     sprintf(buf, "*** Release %d ***rn", m_lCount-1); /* Flawfinder: ignore */
  320.     m_pRaFileDebugLifetime->Write(buf, strlen(buf));
  322.     UINT32* pBinaryStackTrace = NULL;
  324.     if (GetStack(&pBinaryStackTrace))
  325.     {
  326. char* pCharStackTrace = NULL;
  327.      if (GetStackSymbols(pBinaryStackTrace, &pCharStackTrace))
  328. {
  329.     m_pRaFileDebugLifetime->Write
  330.     (
  331. pCharStackTrace,
  332. strlen(pCharStackTrace)
  333.     );
  334. }
  335. HX_VECTOR_DELETE(pCharStackTrace);
  336.     }
  337.     HX_VECTOR_DELETE(pBinaryStackTrace);
  338. }
  340. HX_ASSERT(m_lCount>0);
  342. if (InterlockedDecrement(&m_lCount) > 0)
  343. {
  344.     return m_lCount;
  345. }
  347. FinalRelease();
  348. delete this;
  349. return 0;
  350.     }
  351.     STDMETHOD(FinalConstruct)()
  352.     {
  353. if (m_StringFilename.IsEmpty())
  354. {
  355.     return HXR_OK;
  356. }
  358. char szTemp[32]; /* Flawfinder: ignore */
  359. m_StringFilename.GetBuffer(0)[4] = '';
  360. m_StringFilename.ReleaseBuffer();
  361. ltoa((UINT32)this, szTemp, 16);
  362. m_StringFilename += szTemp;
  363. m_StringFilename.GetBuffer(0)[8] = '.';
  364. if (m_StringFilename.GetLength() > 12)
  365. {                           
  366.     m_StringFilename.GetBuffer(0)[11] = '';
  367.     m_StringFilename.ReleaseBuffer();
  368. }                           
  369. m_pRaFileDebugLifetime = CHXDataFile::Construct();
  370. m_pRaFileDebugLifetime->Open(m_StringFilename, _O_CREAT | _O_RDWR);
  371. m_pRaFileDebugLifetime->Write
  372. (
  373.     "*** Created new class instance ***rn",
  374.     sizeof("*** Created new class instance ***rn")
  375. );
  377. UINT32* pBinaryStackTrace = NULL;
  379. if (GetStack(&pBinaryStackTrace))
  380. {
  381.     char* pCharStackTrace = NULL;
  382.     if (GetStackSymbols(pBinaryStackTrace, &pCharStackTrace))
  383.     {
  384. m_pRaFileDebugLifetime->Write
  385. (
  386.     pCharStackTrace,
  387.     strlen(pCharStackTrace)
  388. );
  389.     }
  390.     HX_VECTOR_DELETE(pCharStackTrace);
  391. }
  393. HX_VECTOR_DELETE(pBinaryStackTrace);
  395. return HXR_OK;
  396.     }
  397.     virtual void FinalRelease()
  398.     {
  399. if (m_pRaFileDebugLifetime)
  400. {
  401.     m_pRaFileDebugLifetime->Write("*** Deleted ***rn", 17);
  402.     UINT32* pBinaryStackTrace = NULL;
  403.     if (GetStack(&pBinaryStackTrace))
  404.     {
  405. char* pCharStackTrace = NULL;
  406. if (GetStackSymbols(pBinaryStackTrace, &pCharStackTrace))
  407. {
  408.     m_pRaFileDebugLifetime->Write
  409.     (
  410. pCharStackTrace,
  411. strlen(pCharStackTrace)
  412.     );
  413. }
  414.         HX_VECTOR_DELETE(pCharStackTrace);
  415.     }
  417.     HX_VECTOR_DELETE(pBinaryStackTrace);
  418.     m_pRaFileDebugLifetime->Close();
  419. }
  421. HX_DELETE(m_pRaFileDebugLifetime);
  422.     }
  423. #else
  424.     // These can be overriden in the derived object to provide
  425.     // an object specific imp.
  426.     STDMETHOD_(ULONG32,ActualAddRef) (THIS)
  427.     {
  428. #ifdef ENABLE_UNKIMP_TRACKER
  429. ULONG32 postAddRefRefCount = InterlockedIncrement(&m_lCount);
  430. if (ms_pIUnknownTracker)
  431. {
  432.     ms_pIUnknownTracker->OnIUnknownAddRef( this, postAddRefRefCount );
  433. }
  434. return postAddRefRefCount;
  435. #else
  436. return InterlockedIncrement(&m_lCount);
  437. #endif
  438.     }
  439.     STDMETHOD_(ULONG32,ActualRelease) (THIS)
  440.     {
  441. HX_ASSERT(m_lCount>0);
  442. #ifdef ENABLE_UNKIMP_TRACKER
  443. ULONG32 preReleaseRefCount = m_lCount;
  444. if (ms_pIUnknownTracker)
  445. {
  446.     ms_pIUnknownTracker->OnIUnknownRelease( this, preReleaseRefCount );
  447. }
  448. #endif
  449. if (InterlockedDecrement(&m_lCount) > 0)
  450. {
  451.     return m_lCount;
  452. }
  454. FinalRelease();
  455. delete this;
  456. return 0;
  457.     }
  458.     STDMETHOD(FinalConstruct)()
  459.     {
  460. return HXR_OK;
  461.     }
  462.     virtual void FinalRelease()
  463.     {
  464.     }
  465. #endif
  466.     LONG32 m_lCount;
  467.     IUnknown* m_punkOuter;
  468.     IUnknown* m_punkControlling;
  470.     friend class CAggregateImpl;
  471. private:
  473.     CUnknownIMP(CUnknownIMP&) : IUnknown () {}
  474.     
  475. #ifdef ENABLE_UNKIMP_TRACKER
  476.     static IHXIUnknownTracker* ms_pIUnknownTracker;
  477. #endif
  478. };
  480. #ifdef INCLUDE_DEBUG_LIFETIME
  481. #define INIT_DEBUG_LIFETIME(CLASS)
  482. CUnknownIMP::InitFilename(#CLASS);
  483. #else
  484. #define INIT_DEBUG_LIFETIME(CLASS)
  485. #endif
  487. #ifdef ENABLE_UNKIMP_TRACKER
  488. #define INIT_UNKIMP_TRACKER 
  489. IHXIUnknownTracker* CUnknownIMP::ms_pIUnknownTracker = NULL;
  490. #endif
  492. class CAggregateImpl : public IUnknown
  493. {
  494. public:
  495.     CAggregateImpl( CUnknownIMP* pobjAggregated )
  496. : m_lCount( 0 )
  497. , m_pobjAggregated( pobjAggregated )
  498.     {}
  499.     virtual ~CAggregateImpl()
  500.     {
  501. delete m_pobjAggregated;
  502.     }
  504.     /*
  505.      * IUnknown methods
  506.      */
  507.     STDMETHOD(QueryInterface)
  508.     (
  509. THIS_
  510. REFIID riid,
  511. void** ppvObj
  512.     )
  513.     {
  514. return m_pobjAggregated->_ActualQI(riid, ppvObj);
  515.     }
  517.     STDMETHOD_(ULONG32,AddRef) (THIS)
  518.     {
  519. #ifdef ENABLE_UNKIMP_TRACKER
  520. ULONG32 postAddRefRefCount = InterlockedIncrement(&m_lCount);
  521. if (CUnknownIMP::ms_pIUnknownTracker)
  522. {
  523.     CUnknownIMP::ms_pIUnknownTracker->OnIUnknownAddRef( m_pobjAggregated, postAddRefRefCount );
  524. }
  525. return postAddRefRefCount;
  526. #else
  527. return InterlockedIncrement(&m_lCount);
  528. #endif
  529.     }
  531.     STDMETHOD_(ULONG32,Release) (THIS)
  532.     {
  533. HX_ASSERT(m_lCount>0);
  534. #ifdef ENABLE_UNKIMP_TRACKER
  535. ULONG32 preReleaseRefCount = m_lCount;
  536. if (CUnknownIMP::ms_pIUnknownTracker)
  537. {
  538.     CUnknownIMP::ms_pIUnknownTracker->OnIUnknownRelease( m_pobjAggregated, preReleaseRefCount );
  539. }
  540. #endif
  541. if (InterlockedDecrement(&m_lCount) > 0)
  542. {
  543.     return m_lCount;
  544. }
  546. delete this;
  547. return 0;
  548.     }
  550. private:
  551.     LONG32 m_lCount;
  552.     CUnknownIMP* m_pobjAggregated;
  554.     CAggregateImpl(){}
  555.     CAggregateImpl(CAggregateImpl&) : IUnknown () {}
  556. };
  559. inline STDMETHODIMP
  560. CUnknownIMP::SetupAggregation( IUnknown* pvOuterObj, IUnknown** pvResult )
  561. {
  562.     if( !pvResult )
  563. return HXR_POINTER;
  565.     // Initial result code, initialize out parameter
  566.     HX_RESULT result = HXR_FAIL;
  567.     *pvResult = NULL;
  569.     // This can only happen before any calls to AddRef()
  570.     HX_ASSERT( 0 == m_lCount );
  572.     if( !m_lCount )
  573.     {
  574. if(pvOuterObj)
  575. {
  576.     m_punkOuter = pvOuterObj;
  577.     m_punkControlling = new CAggregateImpl( this );
  578.     m_punkControlling->AddRef();
  580.     result = HXR_OK;
  581. }
  582. else
  583. {
  584.     result = QueryInterface( IID_IUnknown, (void**) &m_punkControlling );
  585.     HX_ASSERT( SUCCEEDED( result ) );
  586. }
  587.     }
  589.     if( SUCCEEDED( result ) )
  590. *pvResult = m_punkControlling;
  592.     return result;
  593. }
  596. #define DECLARE_UNKNOWN(THIS_CLASS)
  597. DECLARE_COM_CREATE_FUNCS(THIS_CLASS)
  598.     public:
  599. STDMETHOD(QueryInterface)
  600. (
  601.     THIS_
  602.     REFIID riid,
  603.     void** ppvObj
  604. );
  605. STDMETHOD_(ULONG32, AddRef)(THIS);
  606. STDMETHOD_(ULONG32, Release)(THIS);
  607.     protected:
  608. STDMETHOD(_ActualQI)(REFIID riid, void** ppvObj);
  609.     public:
  611. #define DECLARE_UNKNOWN_NOCREATE(THIS_CLASS)
  612.     public:
  613. STDMETHOD(QueryInterface)
  614. (
  615.     THIS_
  616.     REFIID riid,
  617.     void** ppvObj
  618. );
  619. STDMETHOD_(ULONG32, AddRef)(THIS);
  620. STDMETHOD_(ULONG32, Release)(THIS);
  621.     protected:
  622. STDMETHOD(_ActualQI)(REFIID riid, void** ppvObj);
  623.     public:
  625. #define BEGIN_INTERFACE_LIST(THIS_CLASS)
  626. IMPLEMENT_COM_CREATE_FUNCS(THIS_CLASS)
  627. STDMETHODIMP THIS_CLASS::QueryInterface
  628. (
  629.     THIS_
  630.     REFIID riid,
  631.     void** ppvObj
  632. )
  633. {return CUnknownIMP::QueryInterface(riid, ppvObj);}
  634. STDMETHODIMP_(ULONG32) THIS_CLASS::AddRef(THIS)
  635. {return CUnknownIMP::AddRef();}
  636. STDMETHODIMP_(ULONG32) THIS_CLASS::Release(THIS)
  637. {return CUnknownIMP::Release();}
  638. STDMETHODIMP THIS_CLASS::_ActualQI(REFIID riid, void** ppvObj)
  639. {
  640.     if (!ppvObj)
  641. return HXR_POINTER;
  642.     if (IsEqualIID(IID_IUnknown, riid))
  643.     {
  644. AddRef();
  645. *ppvObj = CUnknownIMP::GetUnknown();
  646. return HXR_OK;
  647.     }
  649. #define BEGIN_INTERFACE_LIST_NOCREATE(THIS_CLASS)
  650. STDMETHODIMP THIS_CLASS::QueryInterface
  651. (
  652.     THIS_
  653.     REFIID riid,
  654.     void** ppvObj
  655. )
  656. {return CUnknownIMP::QueryInterface(riid, ppvObj);}
  657. STDMETHODIMP_(ULONG32) THIS_CLASS::AddRef(THIS)
  658. {return CUnknownIMP::AddRef();}
  659. STDMETHODIMP_(ULONG32) THIS_CLASS::Release(THIS)
  660. {return CUnknownIMP::Release();}
  661. STDMETHODIMP THIS_CLASS::_ActualQI(REFIID riid, void** ppvObj)
  662. {
  663.     if (!ppvObj)
  664. return HXR_POINTER;
  665.     if (IsEqualIID(IID_IUnknown, riid))
  666.     {
  667. AddRef();
  668. *ppvObj = CUnknownIMP::GetUnknown();
  669. return HXR_OK;
  670.     }
  672. #define INTERFACE_LIST_ENTRY(INTERFACE_IID, INTERFACE_CLASS)
  673.     if (IsEqualIID(INTERFACE_IID, riid))
  674.     {
  675. AddRef();
  676. INTERFACE_CLASS* pThisAsInterfaceClass = this;  
  677. *ppvObj = pThisAsInterfaceClass;
  678. return HXR_OK;
  679.     }
  681. /*!
  682.     @defined INTERFACE_LIST_ENTRY_BASE
  683.     @discussion Specifies a base class whose query interface function should be called.
  684. */
  685. #define INTERFACE_LIST_ENTRY_BASE( BASE_CLASS )
  686. if( SUCCEEDED( BASE_CLASS::_ActualQI( riid, ppvObj ) ) )
  687. {
  688.     return HXR_OK;
  689. }
  692. #define INTERFACE_LIST_ENTRY2(DERIVED_CLASS, BASE_INTERFACE_IID, BASE_CLASS)
  693.     if (IsEqualIID(BASE_INTERFACE_IID, riid))
  694.     {
  695. AddRef();
  696. DERIVED_CLASS* pTemp1 = this;
  697. BASE_CLASS* pTemp2 = pTemp1;
  698. *ppvObj = pTemp2;
  699. return HXR_OK;
  700.     }
  702. #define INTERFACE_LIST_ENTRY_DELEGATE_BLIND(DELEGATE_QI_FUNCTION)
  703.     if( SUCCEEDED( DELEGATE_QI_FUNCTION( riid, ppvObj ) ) )
  704.     {
  705. return HXR_OK;
  706.     }
  708. #define INTERFACE_LIST_ENTRY_DELEGATE(INTERFACE_IID, DELEGATE_QI_FUNCTION)
  709.     if(IsEqualIID(INTERFACE_IID, riid) &&
  710. SUCCEEDED( DELEGATE_QI_FUNCTION( riid, ppvObj ) ) )
  711.     {
  712. return HXR_OK;
  713.     }
  715. #define END_INTERFACE_LIST
  716.     *ppvObj = NULL;
  717.     return HXR_NOINTERFACE;
  718. }
  720. /*!
  721.     @defined END_INTERFACE_LIST_BASE
  722.     @discussion Ends the list of supported interfaces.  Specifies the base class whose
  723.     query interface function should be called.
  724. */
  725. #define END_INTERFACE_LIST_BASE( BASE_CLASS )
  726. return BASE_CLASS::_ActualQI( riid, ppvObj );
  727.     }                                                       
  731. #define DECLARE_COM_CREATE_FUNCS(CLASS)
  732.     public:
  733. static CLASS* CreateObject();
  734. static HX_RESULT CreateObject(CLASS** ppObj);
  735. static HX_RESULT CreateInstance(IUnknown** ppvObj);
  736. static HX_RESULT CreateInstance
  737. (
  738.     IUnknown* pvOuter,
  739.     IUnknown** ppvObj
  740. );
  742. #define IMPLEMENT_COM_CREATE_FUNCS(CLASS)
  743.     HX_RESULT CLASS::CreateObject(CLASS** ppObj)
  744.     {
  745. *ppObj = new CLASS;
  746. if (*ppObj)
  747. {
  748.     InterlockedIncrement(&((*ppObj)->m_lCount));
  749.     HX_RESULT pnrRes = (*ppObj)->FinalConstruct();
  750.     InterlockedDecrement(&((*ppObj)->m_lCount));
  751.     if (FAILED(pnrRes))
  752.     {
  753. delete (*ppObj);
  754. (*ppObj) = NULL;
  755. return pnrRes;
  756.     }
  757.     return HXR_OK;
  758. }
  759. return HXR_OUTOFMEMORY;    
  760.     }
  761.     CLASS* CLASS::CreateObject()
  762.     {
  763. CLASS* pNew = NULL;
  764. if (SUCCEEDED(CreateObject(&pNew)))
  765. {
  766.     return pNew;
  767. }
  768. return NULL;
  769.     }
  770.     HX_RESULT CLASS::CreateInstance
  771.     (
  772. IUnknown* pvOuterObj,
  773. IUnknown** ppvObj
  774.     )
  775.     {
  776. if (!ppvObj)
  777.     return HXR_POINTER;
  778. *ppvObj = NULL;
  779. CLASS* pNew = NULL;
  780. HX_RESULT pnrRes = CreateObject(&pNew);
  781. if (SUCCEEDED(pnrRes) && pNew)
  782. {
  783.     pnrRes = pNew->SetupAggregation( pvOuterObj, ppvObj );
  784. }
  785. return pnrRes;
  786.     }
  787.     HX_RESULT CLASS::CreateInstance(IUnknown** ppvObj)
  788.     {
  789. return CreateInstance(NULL, ppvObj);
  790.     }
  791.     
  792.     
  794. /*!
  795.     @defined IMPLEMENT_UNKNOWN_NOINTERFACE
  796.     @discussion This fills in implementations for AddRef() and Release()--basically forwards
  797.     calls onto CUnknownIMP.
  798. */
  799. #define IMPLEMENT_UNKNOWN_NOINTERFACE( THIS_CLASS )
  800.     STDMETHODIMP THIS_CLASS::QueryInterface( REFIID riid, void** ppvObj)                              
  801.     {                                                                                                           
  802. return CUnknownIMP::QueryInterface( riid, ppvObj );                                                      
  803.     }
  804.     STDMETHODIMP_(ULONG32) THIS_CLASS::AddRef(THIS) { return CUnknownIMP::AddRef(); }
  805.     STDMETHODIMP_(ULONG32) THIS_CLASS::Release(THIS) { return CUnknownIMP::Release(); }               
  808. /*!
  809.     @defined INTERFACE_LIST_ENTRY_SIMPLE
  810.     @discussion Simplified version of INTERFACE_LIST_ENTRY.  Only takes the interface
  811.     name.  The IID is assumed to be the interface name with 'IID_' prepended.
  812. */
  813. #define INTERFACE_LIST_ENTRY_SIMPLE( INTERFACE_CLASS )
  814. INTERFACE_LIST_ENTRY( IID_##INTERFACE_CLASS, INTERFACE_CLASS )                                        
  816. /*!
  817.     @defined INTERFACE_LIST_ENTRY_SIMPLE2
  818.     @discussion This allows an interface to appear in an interface list 
  819.       even when the conversion to it is ambiguous owing to multiple 
  820.       inheritence. By specifying an intermediate interface the conversion 
  821.       is disambiguated.
  822.       This is the simplified version of INTERFACE_LIST_ENTRY2. Only takes 
  823.       the interface names.  The IID are assumed to be the interface names 
  824.       with 'IID_' prepended.
  825. */
  826. #define INTERFACE_LIST_ENTRY_SIMPLE2( DERIVED_CLASS, BASE_CLASS )
  827. INTERFACE_LIST_ENTRY2( DERIVED_CLASS, IID_##BASE_CLASS, BASE_CLASS )                                        
  831. /*!
  832.     @defined INTERFACE_LIST_ENTRY_TESTPOINTER
  833. */
  834. #define INTERFACE_LIST_ENTRY_MEMBER( INTERFACE_IID, MEMBER_VARIABLE )
  835. if( NULL != ( MEMBER_VARIABLE ) )
  836. {                                                                                               
  837.     if( IsEqualIID( INTERFACE_IID, riid ) )                                                     
  838.     {                                                                                           
  839. if( SUCCEEDED( MEMBER_VARIABLE->QueryInterface( riid, ppvObj ) ) )                      
  840.     return HXR_OK;                                                                      
  841.     }                                                                                           
  842. }                                                                                               
  844. /*!
  845.     @defined INTERFACE_LIST_ENTRY_TESTPOINTER
  846. */
  847. #define INTERFACE_LIST_ENTRY_MEMBER_BLIND( MEMBER_VARIABLE )
  848. if( NULL != ( MEMBER_VARIABLE ) )
  849. {                                                                                               
  850.     if( SUCCEEDED( MEMBER_VARIABLE->QueryInterface( riid, ppvObj ) ) )                      
  851. return HXR_OK;                                                                      
  852. }                                                                                               
  856. #endif //!__CUnknownIMP_H__