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

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

Symbian

开发平台：

C/C++

hxcom.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. #ifndef _HXCOM_H_
  37. #define _HXCOM_H_
  39. #include "hxtypes.h" /* Needed for most type definitions */
  41. // have to use the double expansion to get the prescan level
  43. #define STATCONCAT1(w,x,y,z) STATCONCAT2(w,x,y,z)
  44. #define STATCONCAT2(w,x,y,z) w##x##y##z  
  46. #ifdef _STATICALLY_LINKED
  47. #ifndef _PLUGINNAME
  48. #define ENTRYPOINT(func) STATCONCAT1(entrypoint_error_symbol_should_not_be_needed,_PLUGINNAME,_,func)
  49. #else /* _PLUGINNAME */
  50. #define ENTRYPOINT(func) STATCONCAT1(entrypoint_for_,_PLUGINNAME,_,func)
  51. #endif
  52. #else /* _STATICALLY_LINKED */
  53. #define ENTRYPOINT(func) func
  54. #endif
  56. /*
  57.  * We include objbase.h when building for windows so that hxcom.h can 
  58.  * easily be used in any windows code.
  59.  */
  60. #ifdef _WIN32
  61. #include <objbase.h>
  62. #endif /* _WIN32 */
  65. #include "hxresult.h"
  67. /*
  68.  *  REF:
  69.  * Use this for reference parameters, so that C users can 
  70.  * use the interface as well.
  71.  */
  72. #if defined(__cplusplus)
  73. #define REF(type)   type&
  74. #else
  75. #define REF(type) const type * const
  76. #endif
  78. /*
  79.  *  CONSTMETHOD:
  80.  * Use this for constant methods in an interface 
  81.  * Compiles away under C
  82.  */
  83. #if !defined( CONSTMETHOD )
  85. #if defined(__cplusplus)
  86. #define CONSTMETHOD const
  87. #else
  88. #define CONSTMETHOD
  89. #endif
  91. #endif
  92. /*
  93.  *  CALL:
  94.  *
  95.  * Used by C users to easily call a function through an interface
  96.  *
  97.  *  EXAMPLE:
  98.  *
  99.  * pIFooObject->CALL(IFoo,DoSomething)(bar);
  100.  *
  101.  */
  102. #if !defined(__cplusplus) || defined(CINTERFACE)
  103. #define CALL(iface, func) iface##Vtbl->func
  104. #endif
  107. #define _INTERFACE struct
  109. /*
  110.  * If using windows.h or the windows implementation of COM
  111.  * these defines are not needed.
  112.  */
  113. #if !defined( _OBJBASE_H_ ) 
  115. #ifdef _WIN16
  116. typedef unsigned int MMRESULT;
  117. #define FAR             _far
  118. #else
  119. #define FAR             
  120. #endif /* WIN16 */
  121. #define PASCAL          _pascal
  122. #define CDECL           _cdecl
  124. /*
  125.  * EXTERN_C
  126.  */
  127. #ifndef EXTERN_C
  128. #ifdef __cplusplus
  129. #define EXTERN_C    extern "C"
  130. #else
  131. #define EXTERN_C    extern
  132. #endif
  133. #endif
  135. #ifdef OLDERRORCODES
  136. #ifndef MAKE_HRESULT
  137. #define MAKE_HRESULT(sev,fac,code) ((HRESULT) (((unsigned long)(sev)<<31) | ((unsigned long)(fac)<<16) | ((unsigned long)(code))))
  138. #endif /*MAKE_HRESULT*/
  139. #endif /* OLDERRORCODES */
  141. /*
  142.  *  STDMETHODCALLTYPE
  143.  */
  144. #ifndef STDMETHODCALLTYPE
  145. #if defined(_WIN32) || defined(_MPPC_)
  146. #ifdef _MPPC_
  147. #define STDMETHODCALLTYPE       __cdecl
  148. #else
  149. #define STDMETHODCALLTYPE       __stdcall
  150. #endif
  151. #elif defined(_WIN16)
  152. #define STDMETHODCALLTYPE       __export FAR CDECL
  153. #else
  154. #define STDMETHODCALLTYPE
  155. #endif
  156. #endif
  158. /*
  159.  *  STDMETHODVCALLTYPE
  160.  */
  161. #ifndef STDMETHODVCALLTYPE
  162. #if defined(_WINDOWS) || defined(_MPPC_)
  163. #define STDMETHODVCALLTYPE      __cdecl
  164. #else
  165. #define STDMETHODVCALLTYPE
  166. #endif
  167. #endif
  169. /*
  170.  *  STDAPICALLTYPE
  171.  */
  172. #ifndef STDAPICALLTYPE
  173. #if defined(_WIN32) || defined(_MPPC_)
  174. #define STDAPICALLTYPE          __stdcall
  175. #elif defined(_WIN16)
  176. #define STDAPICALLTYPE          __export FAR PASCAL
  177. #else
  178. #define STDAPICALLTYPE
  179. #endif
  180. #endif
  182. /*
  183.  *  STDAPIVCALLTYPE
  184.  */
  185. #ifndef STDAPIVCALLTYPE
  186. #if defined(_WINDOWS) || defined(_MPPC_)
  187. #define STDAPIVCALLTYPE         __cdecl
  188. #else
  189. #define STDAPIVCALLTYPE
  190. #endif
  191. #endif
  193. /*
  194.  *  Standard API defines:
  195.  *
  196.  * NOTE: the 'V' versions allow Variable Argument lists.
  197.  *
  198.  * STDAPI
  199.  * STDAPI_(type)
  200.  * STDAPIV
  201.  * STDAPIV_(type)
  202.  */
  203. #ifndef STDAPI
  204. #define STDAPI                  EXTERN_C HX_RESULT STDAPICALLTYPE
  205. #endif
  206. #ifndef STDAPI_
  207. #define STDAPI_(type)           EXTERN_C type STDAPICALLTYPE
  208. #endif
  209. #ifndef STDAPIV
  210. #define STDAPIV                 EXTERN_C HX_RESULT STDAPIVCALLTYPE
  211. #endif
  212. #ifndef STDAPIV_
  213. #define STDAPIV_(type)          EXTERN_C type STDAPIVCALLTYPE
  214. #endif
  217. /*
  218.  *  Standard Interface Method defines:
  219.  *
  220.  * NOTE: the 'V' versions allow Variable Argument lists.
  221.  *
  222.  * STDMETHODIMP
  223.  * STDMETHODIMP_(type)
  224.  * STDMETHODIMPV
  225.  * STDMETHODIMPV_(type)
  226.  */
  227. #ifndef STDMETHODIMP
  228. #define STDMETHODIMP            HX_RESULT STDMETHODCALLTYPE
  229. #endif
  230. #ifndef STDMETHODIMP_
  231. #define STDMETHODIMP_(type)     type STDMETHODCALLTYPE
  232. #endif
  233. #ifndef STDMETHODIMPV
  234. #define STDMETHODIMPV           HX_RESULT STDMETHODVCALLTYPE
  235. #endif
  236. #ifndef STDMETHODIMPV_
  237. #define STDMETHODIMPV_(type)    type STDMETHODVCALLTYPE
  238. #endif
  241. #if defined(__cplusplus) && !defined(CINTERFACE)
  242. #define _INTERFACE struct
  243. #define STDMETHOD(method)       virtual HX_RESULT STDMETHODCALLTYPE method
  244. #define STDMETHOD_(type,method) virtual type STDMETHODCALLTYPE method
  245. #define PURE                    = 0
  246. #define THIS_
  247. #define THIS                    void
  249. #if defined(_WINDOWS) && defined(EXPORT_CLASSES)
  250. #define DECLARE_INTERFACE(iface)    _INTERFACE HXEXPORT_CLASS iface
  251. #define DECLARE_INTERFACE_(iface, baseiface)    _INTERFACE HXEXPORT_CLASS iface : public baseiface
  252. #else
  253. #define DECLARE_INTERFACE(iface)    _INTERFACE iface
  254. #define DECLARE_INTERFACE_(iface, baseiface)    _INTERFACE iface : public baseiface
  255. #endif // defined(_WINDOWS) && defined(EXPORT_CLASSES)
  257. #if !defined(BEGIN_INTERFACE)
  258. #if defined(_MPPC_)  && 
  259.     ( (defined(_MSC_VER) || defined(__SC__) || defined(__MWERKS__)) && 
  260.     !defined(NO_NULL_VTABLE_ENTRY) )
  261.    #define BEGIN_INTERFACE virtual void a() {}
  262.    #define END_INTERFACE
  263. #else
  264.    #define BEGIN_INTERFACE
  265.    #define END_INTERFACE
  266. #endif
  267. #endif
  270. #else
  272. #define _INTERFACE               struct
  274. #define STDMETHOD(method)       HX_RESULT (STDMETHODCALLTYPE * method)
  275. #define STDMETHOD_(type,method) type (STDMETHODCALLTYPE * method)
  277. #if !defined(BEGIN_INTERFACE)
  278. #if defined(_MPPC_)
  279.     #define BEGIN_INTERFACE       void    *b;
  280.     #define END_INTERFACE
  281. #else
  282.     #define BEGIN_INTERFACE
  283.     #define END_INTERFACE
  284. #endif
  285. #endif
  288. #define PURE
  289. #define THIS_                   INTERFACE FAR* This,
  290. #define THIS                    INTERFACE FAR* This
  291. #ifdef CONST_VTABLE
  292. #undef CONST_VTBL
  293. #define CONST_VTBL const
  294. #define DECLARE_INTERFACE(iface)    typedef _INTERFACE iface { 
  295.                                     const struct iface##Vtbl FAR* lpVtbl; 
  296.                                 } iface; 
  297.                                 typedef const struct iface##Vtbl iface##Vtbl; 
  298.                                 const struct iface##Vtbl
  299. #else
  300. #undef CONST_VTBL
  301. #define CONST_VTBL
  302. #define DECLARE_INTERFACE(iface)    typedef _INTERFACE iface { 
  303.                                     struct iface##Vtbl FAR* lpVtbl; 
  304.                                 } iface; 
  305.                                 typedef struct iface##Vtbl iface##Vtbl; 
  306.                                 struct iface##Vtbl
  307. #endif
  308. #define DECLARE_INTERFACE_(iface, baseiface)    DECLARE_INTERFACE(iface)
  310. #endif
  312. /*
  313.  *  COMMON TYPES
  314.  */
  316. #if !defined(HELIX_FEATURE_FULLGUID)
  318. #define DEFINE_GUID(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8)
  320. #define DEFINE_GUID_ENUM(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  321.     name = l + w1 * 3 + w2 * 5 + b1 * 7 + b2 * 11 + b3 * 13 + b4 * 17 +   
  322.            b5 * 19 + b6 * 23 + b7 * 29 + b8 * 31,
  324. #ifndef GUID_DEFINED
  325. #define GUID_DEFINED
  326. typedef enum _GUIDNoConflict
  327. {
  328.     GUID_NULL,
  329.     DEFINE_GUID_ENUM(IID_IUnknown, 0x00000000, 0x0000, 0x0000, 0xC0,
  330.                      0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46)
  331.     DEFINE_GUID_ENUM(IID_IMalloc,  0x00000002, 0x0000, 0x0000, 0xC0,
  332.                      0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46)
  333. #include "hxiids.h"
  334. #include "hxpiids.h"
  335.     NUM_GUIDS
  336. } GUID;
  337. #endif
  339. #else /* #if !defined(HELIX_FEATURE_FULLGUID) */
  340. #ifndef GUID_DEFINED
  341. #define GUID_DEFINED
  342. typedef struct  _GUID
  343.     {
  344.     ULONG32 Data1;
  345.     UINT16 Data2;
  346.     UINT16 Data3;
  347.     UCHAR Data4[ 8 ];
  348.     } GUID;
  349. #endif
  350. #endif /* #if !defined(HELIX_FEATURE_FULLGUID) #else */
  352. #if !defined( __IID_DEFINED__ )
  353. #define __IID_DEFINED__
  354. typedef GUID IID;
  355. #define IID_NULL            GUID_NULL
  356. typedef GUID CLSID;
  357. #define CLSID_NULL          GUID_NULL
  359. #if defined(__cplusplus)
  360. #ifndef _REFGUID_DEFINED
  361. #define _REFGUID_DEFINED
  362. #define REFGUID             const GUID &
  363. #endif
  365. #ifndef _REFIID_DEFINED
  366. #define _REFIID_DEFINED
  367. #define REFIID              const IID &
  368. #endif
  370. #ifndef _REFCLSID_DEFINED
  371. #define _REFCLSID_DEFINED
  372. #define REFCLSID            const CLSID &
  373. #endif
  375. #else
  376. #ifndef _REFGUID_DEFINED
  377. #define _REFGUID_DEFINED
  378. #define REFGUID             const GUID * const
  379. #endif
  380. #ifndef _REFIID_DEFINED
  381. #define _REFIID_DEFINED
  382. #define REFIID              const IID * const
  383. #endif
  384. #ifndef _REFCLSID_DEFINED
  385. #define _REFCLSID_DEFINED
  386. #define REFCLSID            const CLSID * const
  387. #endif
  388. #endif
  389. #endif
  392. #if defined(HELIX_FEATURE_FULLGUID)
  394. #if !defined (INITGUID) || (defined (_STATICALLY_LINKED) && !defined(NCIHACK))
  396. #define DEFINE_GUID(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  397.     EXTERN_C const GUID FAR name
  399. #define DEFINE_GUID_ENUM(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  400.     EXTERN_C const GUID FAR name;
  402. #else /* #if !defined (INITGUID) || (defined (_STATICALLY_LINKED) && !defined(NCIHACK)) */
  404. #define DEFINE_GUID(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  405.         EXTERN_C const GUID name 
  406.                 = { l, w1, w2, { b1, b2,  b3,  b4,  b5,  b6,  b7,  b8 } }
  408. #define DEFINE_GUID_ENUM(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  409.         EXTERN_C const GUID name 
  410.                 = { l, w1, w2, { b1, b2,  b3,  b4,  b5,  b6,  b7,  b8 } };
  412. #endif /* #if !defined (INITGUID) || (defined (_STATICALLY_LINKED) && !defined(NCIHACK)) #else */
  414. #endif /* #if defined(HELIX_FEATURE_FULLGUID) */
  416. /* memcmp is in string.h on symbian and MacOSX (or Darwin). */
  417. #if defined(_OPENWAVE) || defined(_MACINTOSH)
  418. #include "hlxclib/string.h"
  419. #elif !defined(_VXWORKS) && !defined(_SYMBIAN) && !defined(_MAC_MACHO)
  420. #include "hlxclib/memory.h" /* for memcmp */
  421. #endif
  424. #ifdef __cplusplus
  425. inline BOOL IsEqualGUID(REFGUID rguid1, REFGUID rguid2)
  426. {
  427. #if defined(HELIX_FEATURE_FULLGUID)
  428.    return !memcmp(&rguid1, &rguid2, sizeof(GUID));
  429. #else // HELIX_FEATURE_FULLGUID
  430.    return (rguid1 == rguid2);
  431. #endif // HELIX_FEATURE_FULLGUID
  432.     
  433. }
  435. inline void SetGUID(GUID& rguid1, REFGUID rguid2)
  436. {
  437. #if defined(HELIX_FEATURE_FULLGUID)
  438.     memcpy(&rguid1, &rguid2, sizeof(GUID)); /* Flawfinder: ignore */
  439. #else // HELIX_FEATURE_FULLGUID
  440.     rguid1 = rguid2;
  441. #endif // HELIX_FEATURE_FULLGUID
  442. }
  443. #else // __cplusplus
  444. #if defined(HELIX_FEATURE_FULLGUID)
  445. #define IsEqualGUID(rguid1, rguid2) (!memcmp(rguid1, rguid2, sizeof(GUID)))
  446. #define SetGUID(rguid1, rguid2) (memcpy(rguid1, rguid2, sizeof(GUID))) /* Flawfinder: ignore */
  447. #else // HELIX_FEATURE_FULLGUID
  448. #define IsEqualGUID(rguid1, rguid2) ((rguid1) == (rguid2))
  449. #define SetGUID(rguid1, rguid2) ((rguid1) = (rguid2))
  450. #endif // HELIX_FEATURE_FULLGUID
  451. #endif // __cplusplus
  453. #define IsEqualIID(riid1, riid2) IsEqualGUID(riid1, riid2)
  454. #define IsEqualCLSID(rclsid1, rclsid2) IsEqualGUID(rclsid1, rclsid2)
  456. #define SetIID(riid1, riid2)     SetGUID(riid1, riid2)
  457. #define SetCLSID(rclsid1, rclsid2)  SetGUID(rclsid1, rclsid2)
  459. #ifdef __cplusplus
  461. /*
  462.  * Because GUID is defined elsewhere in WIN32 land, the operator == and !=
  463.  * are moved outside the class to global scope.
  464.  */
  465. #if defined(HELIX_FEATURE_FULLGUID)
  466. inline BOOL operator==(const GUID& guidOne, const GUID& guidOther)
  467. {
  468.     return !memcmp(&guidOne,&guidOther,sizeof(GUID));
  469. }
  471. inline BOOL operator!=(const GUID& guidOne, const GUID& guidOther)
  472. {
  473.     return !(guidOne == guidOther);
  474. }
  475. #endif // HELIX_FEATURE_FULLGUID
  477. #endif
  480. /****************************************************************************
  481.  * 
  482.  *  Interface:
  483.  *
  484.  * IUnknown
  485.  *
  486.  *  Purpose:
  487.  *
  488.  * Base class of all interfaces. Defines life time management and
  489.  * support for dynamic cast.
  490.  *
  491.  *  IID_IUnknown:
  492.  *
  493.  * {00000000-0000-0000-C000000000000046}
  494.  *
  495.  */
  496. DEFINE_GUID(IID_IUnknown, 0x00000000, 0x0000, 0x0000, 0xC0, 0x00, 
  497. 0x00, 0x00, 0x00, 0x00, 0x00, 0x46);
  499. #undef  INTERFACE
  500. #define INTERFACE   IUnknown
  502. DECLARE_INTERFACE(IUnknown)
  503. {
  504.     STDMETHOD(QueryInterface) (THIS_
  505. REFIID riid,
  506. void** ppvObj) PURE;
  508.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  510.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  511. };
  514. /****************************************************************************
  515.  * 
  516.  *  Interface:
  517.  *
  518.  * IMalloc
  519.  *
  520.  *  Purpose:
  521.  *
  522.  * Basic memory management interface.
  523.  *
  524.  *  IID_IMalloc:
  525.  *
  526.  * {00000002-0000-0000-C000000000000046}
  527.  *
  528.  */
  529. DEFINE_GUID(IID_IMalloc, 00000002, 0x0000, 0x0000, 0xC0, 0x00, 
  530. 0x00, 0x00, 0x00, 0x00, 0x00, 0x46);
  532. #undef  INTERFACE
  533. #define INTERFACE   IMalloc
  535. DECLARE_INTERFACE_(IMalloc, IUnknown)
  536. {
  537.     /*
  538.      * IUnknown methods
  539.      */
  540.     STDMETHOD(QueryInterface) (THIS_
  541. REFIID riid,
  542. void** ppvObj) PURE;
  544.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  546.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  548.     /*
  549.      * IMalloc methods
  550.      */
  551.     STDMETHOD_(void*,Alloc)     (THIS_
  552.     UINT32  /*IN*/ count) PURE;
  554.     STDMETHOD_(void*,Realloc)     (THIS_
  555.     void*   /*IN*/ pMem,
  556.     UINT32  /*IN*/ count) PURE;
  558.     STDMETHOD_(void,Free)     (THIS_
  559.     void*   /*IN*/ pMem) PURE;
  561.     STDMETHOD_(UINT32,GetSize)     (THIS_
  562.     void*   /*IN*/ pMem) PURE;
  564.     STDMETHOD_(BOOL,DidAlloc)     (THIS_
  565.     void*   /*IN*/ pMem) PURE;
  567.     STDMETHOD_(void,HeapMinimize)   (THIS) PURE;
  568. };
  570. #else /* else case of !defined( _OBJBASE_H_ ) && !defined( _COMPOBJ_H_ ) */
  572. // For now, we always use full guids on Windows
  573. #ifndef HELIX_FEATURE_FULLGUID
  574. #define HELIX_FEATURE_FULLGUID
  575. #endif /* HELIX_FEATURE_FULLGUID */
  577. #ifdef DEFINE_GUID
  578. #undef DEFINE_GUID
  579. #endif
  581. #if !defined (INITGUID) || (defined (_STATICALLY_LINKED) && !defined(NCIHACK))
  582. #define DEFINE_GUID(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  583.     EXTERN_C const GUID FAR name
  584. #define DEFINE_GUID_ENUM(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  585.     EXTERN_C const GUID FAR name;
  586. #else
  587. #define DEFINE_GUID(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  588.         EXTERN_C const GUID name 
  589.                 = { l, w1, w2, { b1, b2,  b3,  b4,  b5,  b6,  b7,  b8 } }
  590. #define DEFINE_GUID_ENUM(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  591.         EXTERN_C const GUID name 
  592.                 = { l, w1, w2, { b1, b2,  b3,  b4,  b5,  b6,  b7,  b8 } };
  593. #endif
  596. /* Even in windows we want these GUID's defined... */
  598. #if !(defined(INITGUID) && defined(USE_IUNKNOWN_AND_IMALLOC_FROM_UUID_LIB))
  599. DEFINE_GUID(IID_IUnknown, 0x00000000, 0x0000, 0x0000, 0xC0, 0x00, 
  600. 0x00, 0x00, 0x00, 0x00, 0x00, 0x46);
  602. DEFINE_GUID(IID_IMalloc, 00000002, 0x0000, 0x0000, 0xC0, 0x00, 
  603. 0x00, 0x00, 0x00, 0x00, 0x00, 0x46);
  604. #endif
  606. #include <memory.h> /* for memcmp */
  608. #ifdef __cplusplus
  609. inline void SetGUID(REFGUID rguid1, REFGUID rguid2)
  610. {
  611.     memcpy((void*)&rguid1, (void*)&rguid2, sizeof(GUID)); /* Flawfinder: ignore */
  612. }
  613. #else
  614. #define SetGUID(rguid1, rguid2) (memcpy((void*)rguid1, (void*)rguid2, sizeof(GUID))) /* Flawfinder: ignore */
  615. #endif
  616. #define SetIID(riid1, riid2)     SetGUID(riid1, riid2)
  617. #define SetCLSID(rclsid1, rclsid2)  SetGUID(rclsid1, rclsid2)
  619. #endif /* !defined( _OBJBASE_H_ ) && !defined( _COMPOBJ_H_ )*/
  621. #ifdef __cplusplus
  623. /*
  624.  * This operator is defined for all platforms
  625.  */
  626. #if defined(HELIX_FEATURE_FULLGUID)
  627. inline BOOL operator<(const GUID& lhs, const GUID& rhs)
  628. {
  629.     return memcmp(&lhs, &rhs, sizeof(GUID)) < 0;
  630. }
  631. #endif // HELIX_FEATURE_FULLGUID
  633. #endif // __cplusplus
  636. #ifdef IsEqualIID
  637. #undef IsEqualIID
  638. #endif
  640. #ifdef IsEqualCLSID
  641. #undef IsEqualCLSID
  642. #endif
  644. #define IsEqualIID(riid1, riid2) HXIsEqualGUID(riid1, riid2)
  645. #define IsEqualCLSID(rclsid1, rclsid2) HXIsEqualGUID(rclsid1, rclsid2)
  647. #ifdef __cplusplus
  648. inline BOOL HXIsEqualGUID(REFGUID rguid1, REFGUID rguid2)
  649. {
  650. #if defined(HELIX_FEATURE_FULLGUID)
  651.    return (((UINT32*) &rguid1)[0] == ((UINT32*) &rguid2)[0]  &&
  652.     ((UINT32*) &rguid1)[1] == ((UINT32*) &rguid2)[1] &&
  653.     ((UINT32*) &rguid1)[2] == ((UINT32*) &rguid2)[2] &&
  654.     ((UINT32*) &rguid1)[3] == ((UINT32*) &rguid2)[3]);
  655. #else
  656.    return( (rguid1) == (rguid2) );
  657. #endif
  658. }
  659. #else
  660. #if defined(HELIX_FEATURE_FULLGUID)
  661. #define HXIsEqualGUID(rguid1, rguid2)
  662. (((UINT32*) &rguid1)[0] == ((UINT32*) &rguid2)[0]  &&   
  663.     ((UINT32*) &rguid1)[1] == ((UINT32*) &rguid2)[1] && 
  664.     ((UINT32*) &rguid1)[2] == ((UINT32*) &rguid2)[2] && 
  665.     ((UINT32*) &rguid1)[3] == ((UINT32*) &rguid2)[3]);
  666. #else
  667. #define HXIsEqualGUID(rguid1, rguid2)
  668.    ( (rguid1) == (rguid2) );
  669. #endif
  670. #endif
  672. /****************************************************************************
  673.  *
  674.  *  QueryInterface size reduction structs and functions.
  675.  *
  676.  *  Example Usage:
  677.  *
  678.  *  QInterfaceList qiList[] =
  679.  *   {
  680.  * { GET_IIDHANDLE(IID_IUnknown), (IUnknown*) (IHXPlugin*) this},
  681.  * { GET_IIDHANDLE(IID_IHXPlugin), (IHXPlugin*) this},
  682.  * { GET_IIDHANDLE(IID_IHXFileFormatObject), (IHXFileFormatObject*) this},
  683.  * { GET_IIDHANDLE(IID_IHXAtomizerResponse), (IHXAtomizerResponse*) this},
  684.  * { GET_IIDHANDLE(IID_IHXAtomizationCommander), (IHXAtomizationCommander*) this},
  685.  * { GET_IIDHANDLE(IID_IHXASMSource), (IHXASMSource*) this},
  686.  * { GET_IIDHANDLE(IID_IHXPacketFormat), (IHXPacketFormat*) this},
  687.  * { GET_IIDHANDLE(IID_IHXFileSwitcher), (IHXFileSwitcher*) m_pFileSwitcher},
  688.  * { GET_IIDHANDLE(IID_IHXCommonClassFactory), m_pClassFactory},
  689.  * { GET_IIDHANDLE(IID_IHXScheduler), m_pScheduler}
  690.  *   };
  691.  *
  692.  *   return QIFind(qiList, QILISTSIZE(qiList), riid, ppvObj);
  693.  */
  694. #if !defined(HELIX_FEATURE_FULLGUID)
  696. #define IIDHANDLE     IID
  697. #define GET_IIDHANDLE(x)    (x)
  698. #define DREF_IIDHANDLE(x)   (x)
  700. #else // HELIX_FEATURE_FULLGUID
  702. #define IIDHANDLE     const IID*
  703. #define GET_IIDHANDLE(x)    (&(x))
  704. #define DREF_IIDHANDLE(x)   (*(x))
  706. #endif // HELIX_FEATURE_FULLGUID
  708. typedef struct
  709. {
  710.     IIDHANDLE hiid;
  711.     void* pIFace;
  712. } QInterfaceList;
  714. #define QILISTSIZE(x) sizeof(x)/sizeof(QInterfaceList)
  716. #if !defined(INITGUID) || (defined(_STATICALLY_LINKED) && !defined(NCIHACK))
  717. EXTERN_C HX_RESULT QIFind(QInterfaceList* qiList, UINT32 ulqiListSize, 
  718.   REFIID riid, void** ppvObj);
  719. #else // !INITGUID || (_STATICALLY_LINKED && NCIHACK)
  720. EXTERN_C HX_RESULT QIFind(QInterfaceList* qiList, UINT32 ulqiListSize, 
  721.   REFIID riid, void** ppvObj)
  722. {
  723.     do
  724.     {
  725. if (IsEqualIID(DREF_IIDHANDLE(qiList->hiid), riid))
  726. {
  727.     *ppvObj = (qiList->pIFace);
  728.     if (*ppvObj)
  729.     {
  730. ((IUnknown*) (*ppvObj))->AddRef();
  731. return HXR_OK;
  732.     }
  733.     return HXR_NOINTERFACE;
  734. }
  735. qiList++;
  736.     } while ((--ulqiListSize) != 0);
  738.     *ppvObj = NULL;
  739.     return HXR_NOINTERFACE;
  740. }
  741. #endif // !INITGUID || (_STATICALLY_LINKED && NCIHACK)
  744. /****************************************************************************
  745.  *
  746.  *  Putting the following macro in the definition of your class will overload
  747.  *  new and delete for that object.  New will then take an IMalloc* from
  748.  *  which to allocate memory from and store it in the begining of the
  749.  *  memory which it will return.  Delete will grab this IMalloc* from
  750.  *  the beginning of the mem and use this pointer to deallocate the mem.
  751.  *
  752.  *  Example useage:
  753.  *  class A
  754.  *  {
  755.  *  public:
  756.  *      A(int);
  757.  *      ~A();
  758.  *
  759.  *      IMALLOC_MEM
  760.  *  };
  761.  *
  762.  *  IMalloc* pMalloc;
  763.  *  m_pContext->QueryInterface(IID_IMalloc, (void**)&pMalloc);
  764.  *  A* p = new(pMalloc) A(0);
  765.  *  pMalloc->Release();
  766.  *  delete p;
  767.  */
  769. #define IMALLOC_MEM
  770.     void* operator new(size_t size, IMalloc* pMalloc)
  771.     {
  772.         void* pMem = pMalloc->Alloc(size + sizeof(IMalloc*));
  773.         *(IMalloc**)pMem = pMalloc;
  774.         pMalloc->AddRef();
  775.         return ((unsigned char*)pMem + sizeof(IMalloc*));
  776.     }
  778.     void operator delete(void* pMem)
  779.     {
  780.         pMem = (unsigned char*)pMem - sizeof(IMalloc*);
  781.         IMalloc* pMalloc = *(IMalloc**)pMem;
  782.         pMalloc->Free(pMem);
  783.         pMalloc->Release();
  784.     }
  787. /****************************************************************************
  788.  *
  789.  * By default, we attempt to use atomic InterlockedIncrement/Decrement
  790.  * implementations.  Add HELIX_FEATURE_DISABLE_INTERLOCKED_INC_DEC to 
  791.  * your profile's .pf or to your Umakefil/.pcf file to use non-threadsafe
  792.  * implementations.
  793.  */
  794. #include "atomicbase.h" 
  796. #if !defined HAVE_INTERLOCKED_INCREMENT
  797. #undef InterlockedIncrement
  798. #undef InterlockedDecrement
  799. #define InterlockedIncrement(plong) (++(*(plong)))
  800. #define InterlockedDecrement(plong) (--(*(plong)))
  801. #endif /* !defined HAVE_INTERLOCKED_INCREMENT */
  804. #if defined(HELIX_CONFIG_COMPACT_COM_MACROS)
  806. EXTERN_C void HX_AddRefFunc(IUnknown** pUnk);
  807. EXTERN_C void HX_ReleaseFunc(IUnknown** pUnk);
  809. #if defined(INITGUID) && (!defined(_STATICALLY_LINKED) || defined(NCIHACK))
  811. void HX_AddRefFunc(IUnknown** pUnk)
  812. {
  813.     if (*pUnk)
  814.     {
  815.         (*pUnk)->AddRef();
  816.     }
  817. }
  819. void HX_ReleaseFunc(IUnknown** pUnk)
  820. {
  821.     if (*pUnk)
  822.     {
  823.         (*pUnk)->Release();
  824.         *pUnk = 0;
  825.     }
  826. }
  828. #endif // INITGUID && (!_STATICALLY_LINKED || NCIHACK)
  830. #if defined(HELIX_CONFIG_TYPE_CHECK_COM_MACROS)
  832. #if defined(HELIX_CONFIG_TYPE_CHECK_COM_MACROS_IMPLICIT_CAST)
  834. #define HX_RELEASE(x) (HX_ReleaseFunc(&x))
  835. #define HX_ADDREF(x) (HX_AddRefFunc(&x))
  837. #else // defined(HELIX_CONFIG_TYPE_CHECK_COM_MACROS_IMPLICIT_CAST)
  839. // we don't want to build with this; this should be compiled only
  840. // to ensure that we have a COM object in the code base
  842. #define HX_RELEASE(x) 
  843. { 
  844. if (x) 
  845. { 
  846. IUnknown* pUnk; 
  847. (x)->QueryInterface(IID_IUnknown, (void**)&pUnk); 
  848. if (pUnk) 
  849. { 
  850. pUnk->Release(); 
  851. } 
  852. (x)->Release(); 
  853. (x) = 0; 
  854. } 
  855. } 
  857. #define HX_ADDREF(x) 
  858. { 
  859. if (x) 
  860. { 
  861. IUnknown* pUnk; 
  862. (x)->QueryInterface(IID_IUnknown, (void**)&pUnk); 
  863. if (pUnk) 
  864. { 
  865. pUnk->Release(); 
  866. } 
  867. (x)->AddRef(); 
  868. } 
  869. } 
  871. #endif // defined(HELIX_CONFIG_TYPE_CHECK_COM_MACROS_IMPLICIT_CAST)
  873. #else // defined(HELIX_CONFIG_TYPE_CHECK_COM_MACROS)
  875. #define HX_RELEASE(x) (HX_ReleaseFunc((IUnknown**)&(x)))
  876. #define HX_ADDREF(x) (HX_AddRefFunc((IUnknown**)&(x)))
  878. #endif // defined(HELIX_CONFIG_TYPE_CHECK_COM_MACROS)
  880. #else // defined(HELIX_CONFIG_COMPACT_COM_MACROS)
  882. #define HX_RELEASE(x) ((x) ? ((x)->Release(), (x) = 0) : 0)
  883. #define HX_ADDREF(x) ((x) ? ((x)->AddRef()) : 0)
  885. #endif // defined(HELIX_CONFIG_COMPACT_COM_MACROS)
  889. #endif /* _HXCOM_H_ */