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

源码开发语言/平台
当前位置：首页 > 源码/资料 > 通讯/手机编程 > Symbian > 查看源码
hxcom.h
资源名称：142_61_thumb_advanced.rar　[点击查看]
上传用户：dangjiwu
上传日期：2013-07-19
资源大小：42019k
文件大小：25k
源码类别：

Symbian

开发平台：

Visual C++

hxcom.h：源码内容
  1. /* ***** BEGIN LICENSE BLOCK *****
  2.  * Source last modified: $Id: hxcom.h,v 1.22.2.3 2004/07/09 01:45:08 hubbe Exp $
  3.  * 
  4.  * Portions Copyright (c) 1995-2004 RealNetworks, Inc. All Rights Reserved.
  5.  * 
  6.  * The contents of this file, and the files included with this file,
  7.  * are subject to the current version of the RealNetworks Public
  8.  * Source License (the "RPSL") available at
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed
  10.  * the file under the current version of the RealNetworks Community
  11.  * Source License (the "RCSL") available at
  12.  * http://www.helixcommunity.org/content/rcsl, in which case the RCSL
  13.  * will apply. You may also obtain the license terms directly from
  14.  * RealNetworks.  You may not use this file except in compliance with
  15.  * the RPSL or, if you have a valid RCSL with RealNetworks applicable
  16.  * to this file, the RCSL.  Please see the applicable RPSL or RCSL for
  17.  * the rights, obligations and limitations governing use of the
  18.  * contents of the file.
  19.  * 
  20.  * Alternatively, the contents of this file may be used under the
  21.  * terms of the GNU General Public License Version 2 or later (the
  22.  * "GPL") in which case the provisions of the GPL are applicable
  23.  * instead of those above. If you wish to allow use of your version of
  24.  * this file only under the terms of the GPL, and not to allow others
  25.  * to use your version of this file under the terms of either the RPSL
  26.  * or RCSL, indicate your decision by deleting the provisions above
  27.  * and replace them with the notice and other provisions required by
  28.  * the GPL. If you do not delete the provisions above, a recipient may
  29.  * use your version of this file under the terms of any one of the
  30.  * RPSL, the RCSL or the GPL.
  31.  * 
  32.  * This file is part of the Helix DNA Technology. RealNetworks is the
  33.  * developer of the Original Code and owns the copyrights in the
  34.  * portions it created.
  35.  * 
  36.  * This file, and the files included with this file, is distributed
  37.  * and made available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY
  38.  * KIND, EITHER EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS
  39.  * ALL SUCH WARRANTIES, INCLUDING WITHOUT LIMITATION, ANY WARRANTIES
  40.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, QUIET
  41.  * ENJOYMENT OR NON-INFRINGEMENT.
  42.  * 
  43.  * Technology Compatibility Kit Test Suite(s) Location:
  44.  *    http://www.helixcommunity.org/content/tck
  45.  * 
  46.  * Contributor(s):
  47.  * 
  48.  * ***** END LICENSE BLOCK ***** */
  50. #ifndef _HXCOM_H_
  51. #define _HXCOM_H_
  53. #include "hxtypes.h" /* Needed for most type definitions */
  55. // have to use the double expansion to get the prescan level
  57. #define STATCONCAT1(w,x,y,z) STATCONCAT2(w,x,y,z)
  58. #define STATCONCAT2(w,x,y,z) w##x##y##z  
  60. #ifdef _STATICALLY_LINKED
  61. #ifndef _PLUGINNAME
  62. #define ENTRYPOINT(func) STATCONCAT1(entrypoint_error_symbol_should_not_be_needed,_PLUGINNAME,_,func)
  63. #else /* _PLUGINNAME */
  64. #define ENTRYPOINT(func) STATCONCAT1(entrypoint_for_,_PLUGINNAME,_,func)
  65. #endif
  66. #else /* _STATICALLY_LINKED */
  67. #define ENTRYPOINT(func) func
  68. #endif
  70. /*
  71.  * We include objbase.h when building for windows so that hxcom.h can 
  72.  * easily be used in any windows code.
  73.  */
  74. #ifdef _WIN32
  75. #include <objbase.h>
  76. #endif /* _WIN32 */
  79. #include "hxresult.h"
  81. /*
  82.  *  REF:
  83.  * Use this for reference parameters, so that C users can 
  84.  * use the interface as well.
  85.  */
  86. #if defined(__cplusplus)
  87. #define REF(type)   type&
  88. #else
  89. #define REF(type) const type * const
  90. #endif
  92. /*
  93.  *  CONSTMETHOD:
  94.  * Use this for constant methods in an interface 
  95.  * Compiles away under C
  96.  */
  97. #if !defined( CONSTMETHOD )
  99. #if defined(__cplusplus)
  100. #define CONSTMETHOD const
  101. #else
  102. #define CONSTMETHOD
  103. #endif
  105. #endif
  106. /*
  107.  *  CALL:
  108.  *
  109.  * Used by C users to easily call a function through an interface
  110.  *
  111.  *  EXAMPLE:
  112.  *
  113.  * pIFooObject->CALL(IFoo,DoSomething)(bar);
  114.  *
  115.  */
  116. #if !defined(__cplusplus) || defined(CINTERFACE)
  117. #define CALL(iface, func) iface##Vtbl->func
  118. #endif
  121. #define _INTERFACE struct
  123. /*
  124.  * If using windows.h or the windows implementation of COM
  125.  * these defines are not needed.
  126.  */
  127. #if !defined( _OBJBASE_H_ ) 
  129. #ifdef _WIN16
  130. typedef unsigned int MMRESULT;
  131. #define FAR             _far
  132. #else
  133. #define FAR             
  134. #endif /* WIN16 */
  135. #define PASCAL          _pascal
  136. #define CDECL           _cdecl
  138. /*
  139.  * EXTERN_C
  140.  */
  141. #ifndef EXTERN_C
  142. #ifdef __cplusplus
  143. #define EXTERN_C    extern "C"
  144. #else
  145. #define EXTERN_C    extern
  146. #endif
  147. #endif
  149. #ifdef OLDERRORCODES
  150. #ifndef MAKE_HRESULT
  151. #define MAKE_HRESULT(sev,fac,code) ((HRESULT) (((unsigned long)(sev)<<31) | ((unsigned long)(fac)<<16) | ((unsigned long)(code))))
  152. #endif /*MAKE_HRESULT*/
  153. #endif /* OLDERRORCODES */
  155. /*
  156.  *  STDMETHODCALLTYPE
  157.  */
  158. #ifndef STDMETHODCALLTYPE
  159. #if defined(_WIN32) || defined(_MPPC_)
  160. #ifdef _MPPC_
  161. #define STDMETHODCALLTYPE       __cdecl
  162. #else
  163. #define STDMETHODCALLTYPE       __stdcall
  164. #endif
  165. #elif defined(_WIN16)
  166. #define STDMETHODCALLTYPE       __export FAR CDECL
  167. #else
  168. #define STDMETHODCALLTYPE
  169. #endif
  170. #endif
  172. /*
  173.  *  STDMETHODVCALLTYPE
  174.  */
  175. #ifndef STDMETHODVCALLTYPE
  176. #if defined(_WINDOWS) || defined(_MPPC_)
  177. #define STDMETHODVCALLTYPE      __cdecl
  178. #else
  179. #define STDMETHODVCALLTYPE
  180. #endif
  181. #endif
  183. /*
  184.  *  STDAPICALLTYPE
  185.  */
  186. #ifndef STDAPICALLTYPE
  187. #if defined(_WIN32) || defined(_MPPC_)
  188. #define STDAPICALLTYPE          __stdcall
  189. #elif defined(_WIN16)
  190. #define STDAPICALLTYPE          __export FAR PASCAL
  191. #else
  192. #define STDAPICALLTYPE
  193. #endif
  194. #endif
  196. /*
  197.  *  STDAPIVCALLTYPE
  198.  */
  199. #ifndef STDAPIVCALLTYPE
  200. #if defined(_WINDOWS) || defined(_MPPC_)
  201. #define STDAPIVCALLTYPE         __cdecl
  202. #else
  203. #define STDAPIVCALLTYPE
  204. #endif
  205. #endif
  207. /*
  208.  *  Standard API defines:
  209.  *
  210.  * NOTE: the 'V' versions allow Variable Argument lists.
  211.  *
  212.  * STDAPI
  213.  * STDAPI_(type)
  214.  * STDAPIV
  215.  * STDAPIV_(type)
  216.  */
  217. #ifndef STDAPI
  218. #define STDAPI                  EXTERN_C HX_RESULT STDAPICALLTYPE
  219. #endif
  220. #ifndef STDAPI_
  221. #define STDAPI_(type)           EXTERN_C type STDAPICALLTYPE
  222. #endif
  223. #ifndef STDAPIV
  224. #define STDAPIV                 EXTERN_C HX_RESULT STDAPIVCALLTYPE
  225. #endif
  226. #ifndef STDAPIV_
  227. #define STDAPIV_(type)          EXTERN_C type STDAPIVCALLTYPE
  228. #endif
  231. /*
  232.  *  Standard Interface Method defines:
  233.  *
  234.  * NOTE: the 'V' versions allow Variable Argument lists.
  235.  *
  236.  * STDMETHODIMP
  237.  * STDMETHODIMP_(type)
  238.  * STDMETHODIMPV
  239.  * STDMETHODIMPV_(type)
  240.  */
  241. #ifndef STDMETHODIMP
  242. #define STDMETHODIMP            HX_RESULT STDMETHODCALLTYPE
  243. #endif
  244. #ifndef STDMETHODIMP_
  245. #define STDMETHODIMP_(type)     type STDMETHODCALLTYPE
  246. #endif
  247. #ifndef STDMETHODIMPV
  248. #define STDMETHODIMPV           HX_RESULT STDMETHODVCALLTYPE
  249. #endif
  250. #ifndef STDMETHODIMPV_
  251. #define STDMETHODIMPV_(type)    type STDMETHODVCALLTYPE
  252. #endif
  255. #if defined(__cplusplus) && !defined(CINTERFACE)
  256. #define _INTERFACE struct
  257. #define STDMETHOD(method)       virtual HX_RESULT STDMETHODCALLTYPE method
  258. #define STDMETHOD_(type,method) virtual type STDMETHODCALLTYPE method
  259. #define PURE                    = 0
  260. #define THIS_
  261. #define THIS                    void
  263. #if defined(_WINDOWS) && defined(EXPORT_CLASSES)
  264. #define DECLARE_INTERFACE(iface)    _INTERFACE HXEXPORT_CLASS iface
  265. #define DECLARE_INTERFACE_(iface, baseiface)    _INTERFACE HXEXPORT_CLASS iface : public baseiface
  266. #else
  267. #define DECLARE_INTERFACE(iface)    _INTERFACE iface
  268. #define DECLARE_INTERFACE_(iface, baseiface)    _INTERFACE iface : public baseiface
  269. #endif // defined(_WINDOWS) && defined(EXPORT_CLASSES)
  271. #if !defined(BEGIN_INTERFACE)
  272. #if defined(_MPPC_)  && 
  273.     ( (defined(_MSC_VER) || defined(__SC__) || defined(__MWERKS__)) && 
  274.     !defined(NO_NULL_VTABLE_ENTRY) )
  275.    #define BEGIN_INTERFACE virtual void a() {}
  276.    #define END_INTERFACE
  277. #else
  278.    #define BEGIN_INTERFACE
  279.    #define END_INTERFACE
  280. #endif
  281. #endif
  284. #else
  286. #define _INTERFACE               struct
  288. #define STDMETHOD(method)       HX_RESULT (STDMETHODCALLTYPE * method)
  289. #define STDMETHOD_(type,method) type (STDMETHODCALLTYPE * method)
  291. #if !defined(BEGIN_INTERFACE)
  292. #if defined(_MPPC_)
  293.     #define BEGIN_INTERFACE       void    *b;
  294.     #define END_INTERFACE
  295. #else
  296.     #define BEGIN_INTERFACE
  297.     #define END_INTERFACE
  298. #endif
  299. #endif
  302. #define PURE
  303. #define THIS_                   INTERFACE FAR* This,
  304. #define THIS                    INTERFACE FAR* This
  305. #ifdef CONST_VTABLE
  306. #undef CONST_VTBL
  307. #define CONST_VTBL const
  308. #define DECLARE_INTERFACE(iface)    typedef _INTERFACE iface { 
  309.                                     const struct iface##Vtbl FAR* lpVtbl; 
  310.                                 } iface; 
  311.                                 typedef const struct iface##Vtbl iface##Vtbl; 
  312.                                 const struct iface##Vtbl
  313. #else
  314. #undef CONST_VTBL
  315. #define CONST_VTBL
  316. #define DECLARE_INTERFACE(iface)    typedef _INTERFACE iface { 
  317.                                     struct iface##Vtbl FAR* lpVtbl; 
  318.                                 } iface; 
  319.                                 typedef struct iface##Vtbl iface##Vtbl; 
  320.                                 struct iface##Vtbl
  321. #endif
  322. #define DECLARE_INTERFACE_(iface, baseiface)    DECLARE_INTERFACE(iface)
  324. #endif
  326. /*
  327.  *  COMMON TYPES
  328.  */
  330. #if !defined(HELIX_FEATURE_FULLGUID)
  332. #define DEFINE_GUID(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8)
  334. #define DEFINE_GUID_ENUM(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  335.     name = l + w1 * 3 + w2 * 5 + b1 * 7 + b2 * 11 + b3 * 13 + b4 * 17 +   
  336.            b5 * 19 + b6 * 23 + b7 * 29 + b8 * 31,
  338. #ifndef GUID_DEFINED
  339. #define GUID_DEFINED
  340. typedef enum _GUIDNoConflict
  341. {
  342.     GUID_NULL,
  343.     DEFINE_GUID_ENUM(IID_IUnknown, 0x00000000, 0x0000, 0x0000, 0xC0,
  344.                      0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46)
  345.     DEFINE_GUID_ENUM(IID_IMalloc,  0x00000002, 0x0000, 0x0000, 0xC0,
  346.                      0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46)
  347. #include "hxiids.h"
  348. #include "hxpiids.h"
  349.     NUM_GUIDS
  350. } GUID;
  351. #endif
  353. #else /* #if !defined(HELIX_FEATURE_FULLGUID) */
  354. #ifndef GUID_DEFINED
  355. #define GUID_DEFINED
  356. typedef struct  _GUID
  357.     {
  358.     ULONG32 Data1;
  359.     UINT16 Data2;
  360.     UINT16 Data3;
  361.     UCHAR Data4[ 8 ];
  362.     } GUID;
  363. #endif
  364. #endif /* #if !defined(HELIX_FEATURE_FULLGUID) #else */
  366. #if !defined( __IID_DEFINED__ )
  367. #define __IID_DEFINED__
  368. typedef GUID IID;
  369. #define IID_NULL            GUID_NULL
  370. typedef GUID CLSID;
  371. #define CLSID_NULL          GUID_NULL
  373. #if defined(__cplusplus)
  374. #ifndef _REFGUID_DEFINED
  375. #define _REFGUID_DEFINED
  376. #define REFGUID             const GUID &
  377. #endif
  379. #ifndef _REFIID_DEFINED
  380. #define _REFIID_DEFINED
  381. #define REFIID              const IID &
  382. #endif
  384. #ifndef _REFCLSID_DEFINED
  385. #define _REFCLSID_DEFINED
  386. #define REFCLSID            const CLSID &
  387. #endif
  389. #else
  390. #ifndef _REFGUID_DEFINED
  391. #define _REFGUID_DEFINED
  392. #define REFGUID             const GUID * const
  393. #endif
  394. #ifndef _REFIID_DEFINED
  395. #define _REFIID_DEFINED
  396. #define REFIID              const IID * const
  397. #endif
  398. #ifndef _REFCLSID_DEFINED
  399. #define _REFCLSID_DEFINED
  400. #define REFCLSID            const CLSID * const
  401. #endif
  402. #endif
  403. #endif
  406. #if defined(HELIX_FEATURE_FULLGUID)
  408. #if !defined (INITGUID) || (defined (_STATICALLY_LINKED) && !defined(NCIHACK))
  410. #define DEFINE_GUID(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  411.     EXTERN_C const GUID FAR name
  413. #define DEFINE_GUID_ENUM(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  414.     EXTERN_C const GUID FAR name;
  416. #else /* #if !defined (INITGUID) || (defined (_STATICALLY_LINKED) && !defined(NCIHACK)) */
  418. #define DEFINE_GUID(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  419.         EXTERN_C const GUID name 
  420.                 = { l, w1, w2, { b1, b2,  b3,  b4,  b5,  b6,  b7,  b8 } }
  422. #define DEFINE_GUID_ENUM(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  423.         EXTERN_C const GUID name 
  424.                 = { l, w1, w2, { b1, b2,  b3,  b4,  b5,  b6,  b7,  b8 } };
  426. #endif /* #if !defined (INITGUID) || (defined (_STATICALLY_LINKED) && !defined(NCIHACK)) #else */
  428. #endif /* #if defined(HELIX_FEATURE_FULLGUID) */
  430. /* memcmp is in string.h on symbian and MacOSX (or Darwin). */
  431. #if defined(_OPENWAVE) || defined(_MACINTOSH)
  432. #include "hlxclib/string.h"
  433. #elif !defined(_VXWORKS) && !defined(_SYMBIAN) && !defined(_MAC_MACHO)
  434. #include "hlxclib/memory.h" /* for memcmp */
  435. #endif
  438. #ifdef __cplusplus
  439. inline BOOL IsEqualGUID(REFGUID rguid1, REFGUID rguid2)
  440. {
  441. #if defined(HELIX_FEATURE_FULLGUID)
  442.    return !memcmp(&rguid1, &rguid2, sizeof(GUID));
  443. #else // HELIX_FEATURE_FULLGUID
  444.    return (rguid1 == rguid2);
  445. #endif // HELIX_FEATURE_FULLGUID
  446.     
  447. }
  449. inline void SetGUID(GUID& rguid1, REFGUID rguid2)
  450. {
  451. #if defined(HELIX_FEATURE_FULLGUID)
  452.     memcpy(&rguid1, &rguid2, sizeof(GUID)); /* Flawfinder: ignore */
  453. #else // HELIX_FEATURE_FULLGUID
  454.     rguid1 = rguid2;
  455. #endif // HELIX_FEATURE_FULLGUID
  456. }
  457. #else // __cplusplus
  458. #if defined(HELIX_FEATURE_FULLGUID)
  459. #define IsEqualGUID(rguid1, rguid2) (!memcmp(rguid1, rguid2, sizeof(GUID)))
  460. #define SetGUID(rguid1, rguid2) (memcpy(rguid1, rguid2, sizeof(GUID))) /* Flawfinder: ignore */
  461. #else // HELIX_FEATURE_FULLGUID
  462. #define IsEqualGUID(rguid1, rguid2) ((rguid1) == (rguid2))
  463. #define SetGUID(rguid1, rguid2) ((rguid1) = (rguid2))
  464. #endif // HELIX_FEATURE_FULLGUID
  465. #endif // __cplusplus
  467. #define IsEqualIID(riid1, riid2) IsEqualGUID(riid1, riid2)
  468. #define IsEqualCLSID(rclsid1, rclsid2) IsEqualGUID(rclsid1, rclsid2)
  470. #define SetIID(riid1, riid2)     SetGUID(riid1, riid2)
  471. #define SetCLSID(rclsid1, rclsid2)  SetGUID(rclsid1, rclsid2)
  473. #ifdef __cplusplus
  475. /*
  476.  * Because GUID is defined elsewhere in WIN32 land, the operator == and !=
  477.  * are moved outside the class to global scope.
  478.  */
  479. #if defined(HELIX_FEATURE_FULLGUID)
  480. inline BOOL operator==(const GUID& guidOne, const GUID& guidOther)
  481. {
  482.     return !memcmp(&guidOne,&guidOther,sizeof(GUID));
  483. }
  485. inline BOOL operator!=(const GUID& guidOne, const GUID& guidOther)
  486. {
  487.     return !(guidOne == guidOther);
  488. }
  489. #endif // HELIX_FEATURE_FULLGUID
  491. #endif
  494. /****************************************************************************
  495.  * 
  496.  *  Interface:
  497.  *
  498.  * IUnknown
  499.  *
  500.  *  Purpose:
  501.  *
  502.  * Base class of all interfaces. Defines life time management and
  503.  * support for dynamic cast.
  504.  *
  505.  *  IID_IUnknown:
  506.  *
  507.  * {00000000-0000-0000-C000000000000046}
  508.  *
  509.  */
  510. DEFINE_GUID(IID_IUnknown, 0x00000000, 0x0000, 0x0000, 0xC0, 0x00, 
  511. 0x00, 0x00, 0x00, 0x00, 0x00, 0x46);
  513. #undef  INTERFACE
  514. #define INTERFACE   IUnknown
  516. DECLARE_INTERFACE(IUnknown)
  517. {
  518.     STDMETHOD(QueryInterface) (THIS_
  519. REFIID riid,
  520. void** ppvObj) PURE;
  522.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  524.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  525. };
  528. /****************************************************************************
  529.  * 
  530.  *  Interface:
  531.  *
  532.  * IMalloc
  533.  *
  534.  *  Purpose:
  535.  *
  536.  * Basic memory management interface.
  537.  *
  538.  *  IID_IMalloc:
  539.  *
  540.  * {00000002-0000-0000-C000000000000046}
  541.  *
  542.  */
  543. DEFINE_GUID(IID_IMalloc, 00000002, 0x0000, 0x0000, 0xC0, 0x00, 
  544. 0x00, 0x00, 0x00, 0x00, 0x00, 0x46);
  546. #undef  INTERFACE
  547. #define INTERFACE   IMalloc
  549. DECLARE_INTERFACE_(IMalloc, IUnknown)
  550. {
  551.     /*
  552.      * IUnknown methods
  553.      */
  554.     STDMETHOD(QueryInterface) (THIS_
  555. REFIID riid,
  556. void** ppvObj) PURE;
  558.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  560.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  562.     /*
  563.      * IMalloc methods
  564.      */
  565.     STDMETHOD_(void*,Alloc)     (THIS_
  566.     UINT32  /*IN*/ count) PURE;
  568.     STDMETHOD_(void*,Realloc)     (THIS_
  569.     void*   /*IN*/ pMem,
  570.     UINT32  /*IN*/ count) PURE;
  572.     STDMETHOD_(void,Free)     (THIS_
  573.     void*   /*IN*/ pMem) PURE;
  575.     STDMETHOD_(UINT32,GetSize)     (THIS_
  576.     void*   /*IN*/ pMem) PURE;
  578.     STDMETHOD_(BOOL,DidAlloc)     (THIS_
  579.     void*   /*IN*/ pMem) PURE;
  581.     STDMETHOD_(void,HeapMinimize)   (THIS) PURE;
  582. };
  584. #else /* else case of !defined( _OBJBASE_H_ ) && !defined( _COMPOBJ_H_ ) */
  586. // For now, we always use full guids on Windows
  587. #ifndef HELIX_FEATURE_FULLGUID
  588. #define HELIX_FEATURE_FULLGUID
  589. #endif /* HELIX_FEATURE_FULLGUID */
  591. #ifdef DEFINE_GUID
  592. #undef DEFINE_GUID
  593. #endif
  595. #if !defined (INITGUID) || (defined (_STATICALLY_LINKED) && !defined(NCIHACK))
  596. #define DEFINE_GUID(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  597.     EXTERN_C const GUID FAR name
  598. #define DEFINE_GUID_ENUM(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  599.     EXTERN_C const GUID FAR name;
  600. #else
  601. #define DEFINE_GUID(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  602.         EXTERN_C const GUID name 
  603.                 = { l, w1, w2, { b1, b2,  b3,  b4,  b5,  b6,  b7,  b8 } }
  604. #define DEFINE_GUID_ENUM(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) 
  605.         EXTERN_C const GUID name 
  606.                 = { l, w1, w2, { b1, b2,  b3,  b4,  b5,  b6,  b7,  b8 } };
  607. #endif
  610. /* Even in windows we want these GUID's defined... */
  612. #if !(defined(INITGUID) && defined(USE_IUNKNOWN_AND_IMALLOC_FROM_UUID_LIB))
  613. DEFINE_GUID(IID_IUnknown, 0x00000000, 0x0000, 0x0000, 0xC0, 0x00, 
  614. 0x00, 0x00, 0x00, 0x00, 0x00, 0x46);
  616. DEFINE_GUID(IID_IMalloc, 00000002, 0x0000, 0x0000, 0xC0, 0x00, 
  617. 0x00, 0x00, 0x00, 0x00, 0x00, 0x46);
  618. #endif
  620. #include <memory.h> /* for memcmp */
  622. #ifdef __cplusplus
  623. inline void SetGUID(REFGUID rguid1, REFGUID rguid2)
  624. {
  625.     memcpy((void*)&rguid1, (void*)&rguid2, sizeof(GUID)); /* Flawfinder: ignore */
  626. }
  627. #else
  628. #define SetGUID(rguid1, rguid2) (memcpy((void*)rguid1, (void*)rguid2, sizeof(GUID))) /* Flawfinder: ignore */
  629. #endif
  630. #define SetIID(riid1, riid2)     SetGUID(riid1, riid2)
  631. #define SetCLSID(rclsid1, rclsid2)  SetGUID(rclsid1, rclsid2)
  633. #endif /* !defined( _OBJBASE_H_ ) && !defined( _COMPOBJ_H_ )*/
  635. #ifdef __cplusplus
  637. /*
  638.  * This operator is defined for all platforms
  639.  */
  640. #if defined(HELIX_FEATURE_FULLGUID)
  641. inline BOOL operator<(const GUID& lhs, const GUID& rhs)
  642. {
  643.     return memcmp(&lhs, &rhs, sizeof(GUID)) < 0;
  644. }
  645. #endif // HELIX_FEATURE_FULLGUID
  647. #endif // __cplusplus
  650. #ifdef IsEqualIID
  651. #undef IsEqualIID
  652. #endif
  654. #ifdef IsEqualCLSID
  655. #undef IsEqualCLSID
  656. #endif
  658. #define IsEqualIID(riid1, riid2) HXIsEqualGUID(riid1, riid2)
  659. #define IsEqualCLSID(rclsid1, rclsid2) HXIsEqualGUID(rclsid1, rclsid2)
  661. #ifdef __cplusplus
  662. inline BOOL HXIsEqualGUID(REFGUID rguid1, REFGUID rguid2)
  663. {
  664. #if defined(HELIX_FEATURE_FULLGUID)
  665.    return (((UINT32*) &rguid1)[0] == ((UINT32*) &rguid2)[0]  &&
  666.     ((UINT32*) &rguid1)[1] == ((UINT32*) &rguid2)[1] &&
  667.     ((UINT32*) &rguid1)[2] == ((UINT32*) &rguid2)[2] &&
  668.     ((UINT32*) &rguid1)[3] == ((UINT32*) &rguid2)[3]);
  669. #else
  670.    return( (rguid1) == (rguid2) );
  671. #endif
  672. }
  673. #else
  674. #if defined(HELIX_FEATURE_FULLGUID)
  675. #define HXIsEqualGUID(rguid1, rguid2)
  676. (((UINT32*) &rguid1)[0] == ((UINT32*) &rguid2)[0]  &&   
  677.     ((UINT32*) &rguid1)[1] == ((UINT32*) &rguid2)[1] && 
  678.     ((UINT32*) &rguid1)[2] == ((UINT32*) &rguid2)[2] && 
  679.     ((UINT32*) &rguid1)[3] == ((UINT32*) &rguid2)[3]);
  680. #else
  681. #define HXIsEqualGUID(rguid1, rguid2)
  682.    ( (rguid1) == (rguid2) );
  683. #endif
  684. #endif
  686. /****************************************************************************
  687.  *
  688.  *  QueryInterface size reduction structs and functions.
  689.  *
  690.  *  Example Usage:
  691.  *
  692.  *  QInterfaceList qiList[] =
  693.  *   {
  694.  * { GET_IIDHANDLE(IID_IUnknown), (IUnknown*) (IHXPlugin*) this},
  695.  * { GET_IIDHANDLE(IID_IHXPlugin), (IHXPlugin*) this},
  696.  * { GET_IIDHANDLE(IID_IHXFileFormatObject), (IHXFileFormatObject*) this},
  697.  * { GET_IIDHANDLE(IID_IHXAtomizerResponse), (IHXAtomizerResponse*) this},
  698.  * { GET_IIDHANDLE(IID_IHXAtomizationCommander), (IHXAtomizationCommander*) this},
  699.  * { GET_IIDHANDLE(IID_IHXASMSource), (IHXASMSource*) this},
  700.  * { GET_IIDHANDLE(IID_IHXPacketFormat), (IHXPacketFormat*) this},
  701.  * { GET_IIDHANDLE(IID_IHXFileSwitcher), (IHXFileSwitcher*) m_pFileSwitcher},
  702.  * { GET_IIDHANDLE(IID_IHXCommonClassFactory), m_pClassFactory},
  703.  * { GET_IIDHANDLE(IID_IHXScheduler), m_pScheduler}
  704.  *   };
  705.  *
  706.  *   return QIFind(qiList, QILISTSIZE(qiList), riid, ppvObj);
  707.  */
  708. #if !defined(HELIX_FEATURE_FULLGUID)
  710. #define IIDHANDLE     IID
  711. #define GET_IIDHANDLE(x)    (x)
  712. #define DREF_IIDHANDLE(x)   (x)
  714. #else // HELIX_FEATURE_FULLGUID
  716. #define IIDHANDLE     const IID*
  717. #define GET_IIDHANDLE(x)    (&(x))
  718. #define DREF_IIDHANDLE(x)   (*(x))
  720. #endif // HELIX_FEATURE_FULLGUID
  722. typedef struct
  723. {
  724.     IIDHANDLE hiid;
  725.     void* pIFace;
  726. } QInterfaceList;
  728. #define QILISTSIZE(x) sizeof(x)/sizeof(QInterfaceList)
  730. #if !defined(INITGUID) || (defined(_STATICALLY_LINKED) && !defined(NCIHACK))
  731. EXTERN_C HX_RESULT QIFind(QInterfaceList* qiList, UINT32 ulqiListSize, 
  732.   REFIID riid, void** ppvObj);
  733. #else // !INITGUID || (_STATICALLY_LINKED && NCIHACK)
  734. EXTERN_C HX_RESULT QIFind(QInterfaceList* qiList, UINT32 ulqiListSize, 
  735.   REFIID riid, void** ppvObj)
  736. {
  737.     do
  738.     {
  739. if (IsEqualIID(DREF_IIDHANDLE(qiList->hiid), riid))
  740. {
  741.     *ppvObj = (qiList->pIFace);
  742.     if (*ppvObj)
  743.     {
  744. ((IUnknown*) (*ppvObj))->AddRef();
  745. return HXR_OK;
  746.     }
  747.     return HXR_NOINTERFACE;
  748. }
  749. qiList++;
  750.     } while ((--ulqiListSize) != 0);
  752.     *ppvObj = NULL;
  753.     return HXR_NOINTERFACE;
  754. }
  755. #endif // !INITGUID || (_STATICALLY_LINKED && NCIHACK)
  758. /****************************************************************************
  759.  *
  760.  *  Putting the following macro in the definition of your class will overload
  761.  *  new and delete for that object.  New will then take an IMalloc* from
  762.  *  which to allocate memory from and store it in the begining of the
  763.  *  memory which it will return.  Delete will grab this IMalloc* from
  764.  *  the beginning of the mem and use this pointer to deallocate the mem.
  765.  *
  766.  *  Example useage:
  767.  *  class A
  768.  *  {
  769.  *  public:
  770.  *      A(int);
  771.  *      ~A();
  772.  *
  773.  *      IMALLOC_MEM
  774.  *  };
  775.  *
  776.  *  IMalloc* pMalloc;
  777.  *  m_pContext->QueryInterface(IID_IMalloc, (void**)&pMalloc);
  778.  *  A* p = new(pMalloc) A(0);
  779.  *  pMalloc->Release();
  780.  *  delete p;
  781.  */
  783. #define IMALLOC_MEM
  784.     void* operator new(size_t size, IMalloc* pMalloc)
  785.     {
  786.         void* pMem = pMalloc->Alloc(size + sizeof(IMalloc*));
  787.         *(IMalloc**)pMem = pMalloc;
  788.         pMalloc->AddRef();
  789.         return ((unsigned char*)pMem + sizeof(IMalloc*));
  790.     }
  792.     void operator delete(void* pMem)
  793.     {
  794.         pMem = (unsigned char*)pMem - sizeof(IMalloc*);
  795.         IMalloc* pMalloc = *(IMalloc**)pMem;
  796.         pMalloc->Free(pMem);
  797.         pMalloc->Release();
  798.     }
  801. /****************************************************************************
  802.  *
  803.  * By default, we attempt to use atomic InterlockedIncrement/Decrement
  804.  * implementations.  Add HELIX_FEATURE_DISABLE_INTERLOCKED_INC_DEC to 
  805.  * your profile's .pf or to your Umakefil/.pcf file to use non-threadsafe
  806.  * implementations.
  807.  */
  808. #include "atomicbase.h" 
  810. #if !defined HAVE_INTERLOCKED_INCREMENT
  811. #undef InterlockedIncrement
  812. #undef InterlockedDecrement
  813. #define InterlockedIncrement(plong) (++(*(plong)))
  814. #define InterlockedDecrement(plong) (--(*(plong)))
  815. #endif /* !defined HAVE_INTERLOCKED_INCREMENT */
  818. #if defined(HELIX_CONFIG_COMPACT_COM_MACROS)
  820. EXTERN_C void HX_AddRefFunc(IUnknown** pUnk);
  821. EXTERN_C void HX_ReleaseFunc(IUnknown** pUnk);
  823. #if defined(INITGUID) && (!defined(_STATICALLY_LINKED) || defined(NCIHACK))
  825. void HX_AddRefFunc(IUnknown** pUnk)
  826. {
  827.     if (*pUnk)
  828.     {
  829.         (*pUnk)->AddRef();
  830.     }
  831. }
  833. void HX_ReleaseFunc(IUnknown** pUnk)
  834. {
  835.     if (*pUnk)
  836.     {
  837.         (*pUnk)->Release();
  838.         *pUnk = 0;
  839.     }
  840. }
  842. #endif // INITGUID && (!_STATICALLY_LINKED || NCIHACK)
  844. #if defined(HELIX_CONFIG_TYPE_CHECK_COM_MACROS)
  846. #if defined(HELIX_CONFIG_TYPE_CHECK_COM_MACROS_IMPLICIT_CAST)
  848. #define HX_RELEASE(x) (HX_ReleaseFunc(&x))
  849. #define HX_ADDREF(x) (HX_AddRefFunc(&x))
  851. #else // defined(HELIX_CONFIG_TYPE_CHECK_COM_MACROS_IMPLICIT_CAST)
  853. // we don't want to build with this; this should be compiled only
  854. // to ensure that we have a COM object in the code base
  856. #define HX_RELEASE(x) 
  857. { 
  858. if (x) 
  859. { 
  860. IUnknown* pUnk; 
  861. (x)->QueryInterface(IID_IUnknown, (void**)&pUnk); 
  862. if (pUnk) 
  863. { 
  864. pUnk->Release(); 
  865. } 
  866. (x)->Release(); 
  867. (x) = 0; 
  868. } 
  869. } 
  871. #define HX_ADDREF(x) 
  872. { 
  873. if (x) 
  874. { 
  875. IUnknown* pUnk; 
  876. (x)->QueryInterface(IID_IUnknown, (void**)&pUnk); 
  877. if (pUnk) 
  878. { 
  879. pUnk->Release(); 
  880. } 
  881. (x)->AddRef(); 
  882. } 
  883. } 
  885. #endif // defined(HELIX_CONFIG_TYPE_CHECK_COM_MACROS_IMPLICIT_CAST)
  887. #else // defined(HELIX_CONFIG_TYPE_CHECK_COM_MACROS)
  889. #define HX_RELEASE(x) (HX_ReleaseFunc((IUnknown**)&(x)))
  890. #define HX_ADDREF(x) (HX_AddRefFunc((IUnknown**)&(x)))
  892. #endif // defined(HELIX_CONFIG_TYPE_CHECK_COM_MACROS)
  894. #else // defined(HELIX_CONFIG_COMPACT_COM_MACROS)
  896. #define HX_RELEASE(x) ((x) ? ((x)->Release(), (x) = 0) : 0)
  897. #define HX_ADDREF(x) ((x) ? ((x)->AddRef()) : 0)
  899. #endif // defined(HELIX_CONFIG_COMPACT_COM_MACROS)
  903. #endif /* _HXCOM_H_ */