hxplugindll.h
上传用户:dangjiwu
上传日期:2013-07-19
资源大小:42019k
文件大小:5k
源码类别:

Symbian

开发平台:

Visual C++

  1. /* ***** BEGIN LICENSE BLOCK *****
  2.  * Source last modified: $Id: hxplugindll.h,v 1.2.2.1 2004/07/09 02:07:18 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 ***** */
  49. #ifndef HXPLUGINDLL_H__
  50. #define HXPLUGINDLL_H__
  51. #include "hxstring.h"
  52. #include "hxtypes.h"
  53. #include "hxcom.h"
  54. #include "unkimp.h"
  55. #include "hxslist.h"
  56. class HXPluginManager;
  57. class HXPluginArchiveReader;
  58. class HXPluginArchiveWriter;
  59. typedef HX_RESULT (HXEXPORT_PTR FPCREATEINSTANCE) (IUnknown** /*OUT*/ ppIUnknown);
  60. typedef HX_RESULT (HXEXPORT_PTR FPSHUTDOWN) ();
  61. typedef HX_RESULT (HXEXPORT_PTR FPCANUNLOAD2) ();
  62. //
  63. // used to identify plugin type when plugin object is written to/read from archive
  64. //
  65. enum
  66. {
  67.     ARCHIVE_ID_OTHER_DLL = 1,
  68.     ARCHIVE_ID_PLUGIN_DLL
  69. };
  70. // class HXOtherDLL
  71. class HXOtherDLL
  72. : public CUnknownIMP
  73. {
  74. public:
  75.     DECLARE_UNKNOWN_NOCREATE(HXPluginDLL)
  76. public:
  77.     HXOtherDLL(const char* pszFileName, const char* pszMountPoint);
  78.     HXOtherDLL(const char* pszMountPoint, HXPluginArchiveReader& ar);
  79.     const CHXString& GetMountPoint() const;
  80.     const CHXString& GetFileName() const;
  81.     void Archive(HXPluginArchiveWriter& ar);
  82. private:
  83.     CHXString m_strFileName;
  84.     CHXString m_strMountPoint;
  85. };
  86. inline 
  87. const CHXString& HXOtherDLL::GetMountPoint() const { return m_strMountPoint; }
  88. inline
  89. const CHXString& HXOtherDLL::GetFileName() const { return m_strFileName; }
  90. // class HXPluginDLL
  91. class HXPluginDLL 
  92. : public CUnknownIMP
  93. {
  94. public:
  95.     DECLARE_UNKNOWN_NOCREATE(HXPluginDLL)
  96. public:
  97.     HXPluginDLL(IUnknown* pContext, const char* pszFileName, const char* pszMountPoint);
  98.     HXPluginDLL(IUnknown* pContext, const char* pszMountPoint, HXPluginArchiveReader& ar);
  99.     ~HXPluginDLL();
  100.     void Archive(HXPluginArchiveWriter& ar);
  101.     HX_RESULT Load();
  102.     HX_RESULT Unload(bool bForce = false);
  103.     BOOL IsLoaded();
  104.     HX_RESULT CreateInstance( IUnknown** ppUnk, UINT32 uIndex );
  105.     const CHXString& GetMountPoint() const;
  106.     const CHXString& GetFileName() const;
  107.     UINT32 GetNumPlugins();
  108.     void AddPlugins(CHXSimpleList& list);
  109.     
  110. private:
  111. // implementation
  112.     void Init(IUnknown* pContext);
  113.     HX_RESULT CreatePlugins();
  114.     void CreateComponentPlugins(IHXComponentPlugin* pComponentPlugin);
  115. private:
  116.     FPCREATEINSTANCE m_fpCreateInstance;
  117.     FPSHUTDOWN m_fpShutdown;
  118.     FPCANUNLOAD2 m_fCanUnload;
  119.     CHXString           m_strMountPoint;
  120.     CHXString           m_strFileName;
  121.  
  122.     UINT16 m_pluginCount;
  123.     bool m_bHasFactory;
  124.     bool m_bLoaded;
  125.     DLLAccess* m_pDLLAccess;
  126.     CHXSimpleList m_plugins;
  127.     IUnknown*           m_pContext;
  128.     IHXCommonClassFactory*  m_pClassFactory;
  129. };
  130. inline
  131. const CHXString& HXPluginDLL::GetMountPoint() const 
  132.     return m_strMountPoint; 
  133. }
  134. inline
  135. const CHXString& HXPluginDLL::GetFileName() const 
  136.     return m_strFileName; 
  137. }
  138. inline
  139. UINT32 HXPluginDLL::GetNumPlugins() 
  140.     return m_pluginCount; 
  141. }
  142. #endif /* HXPLUGINDLL_H__ */