hxplugindll.cpp

著名的 helix realplayer 基于手机 symbian 系统的 播放器全套源代码

/* ***** BEGIN LICENSE BLOCK *****
 * Version: RCSL 1.0/RPSL 1.0
 *
 * Portions Copyright (c) 1995-2002 RealNetworks, Inc. All Rights Reserved.
 *
 * The contents of this file, and the files included with this file, are
 * subject to the current version of the RealNetworks Public Source License
 * Version 1.0 (the "RPSL") available at
 * http://www.helixcommunity.org/content/rpsl unless you have licensed
 * the file under the RealNetworks Community Source License Version 1.0
 * (the "RCSL") available at http://www.helixcommunity.org/content/rcsl,
 * in which case the RCSL will apply. You may also obtain the license terms
 * directly from RealNetworks.  You may not use this file except in
 * compliance with the RPSL or, if you have a valid RCSL with RealNetworks
 * applicable to this file, the RCSL.  Please see the applicable RPSL or
 * RCSL for the rights, obligations and limitations governing use of the
 * contents of the file.
 *
 * This file is part of the Helix DNA Technology. RealNetworks is the
 * developer of the Original Code and owns the copyrights in the portions
 * it created.
 *
 * This file, and the files included with this file, is distributed and made
 * available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
 * EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS ALL SUCH WARRANTIES,
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS
 * FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
 *
 * Technology Compatibility Kit Test Suite(s) Location:
 *    http://www.helixcommunity.org/content/tck
 *
 * Contributor(s):
 *
 * ***** END LICENSE BLOCK ***** */

#include "hxtypes.h"
#include "hlxclib/sys/stat.h"
#include "hlxclib/stdio.h"

#include "hxresult.h"
#include "hxassert.h"
#include "hxcom.h"
#include "hxcomm.h"
#include "hxplugn.h" //IHXPluginFactory
#include "ihxpckts.h" // IHXBuffer
#include "hxstring.h"
#include "hxslist.h"
#include "pathutil.h"

#include "dllacces.h"
#include "dllpath.h"

#include "debug.h"

#include "hxheap.h"
#ifdef _DEBUG
#undef HX_THIS_FILE
static const char HX_THIS_FILE[] = __FILE__;
#endif

#if defined(_STATICALLY_LINKED)
#include "staticff.h"
#endif

#include "hxpluginarchive.h"
#include "hxplugin.h"
#include "hxplugindll.h"



BEGIN_INTERFACE_LIST_NOCREATE(HXPluginDLL)
END_INTERFACE_LIST

HXPluginDLL::HXPluginDLL( IUnknown* pContext,
                         const char* pszFileName, 
                         const char * pszMountPoint)
: m_fpCreateInstance(0)
, m_fpShutdown(0)
, m_fCanUnload(0)
, m_strFileName(pszFileName)
, m_strMountPoint(pszMountPoint)
, m_pluginCount(0)
, m_pDLLAccess(0)
, m_bHasFactory(FALSE)
, m_bLoaded(FALSE)
, m_pContext(0)
, m_pClassFactory(0)
{
    DPRINTF(D_INFO, ("HXPluginDLL::HXPluginDLL()\n"));
    Init(pContext);
    
}

// common ctor init
void HXPluginDLL::Init(IUnknown* pContext)
{
    HX_ASSERT(pContext);
    m_pContext = pContext;
    m_pContext->AddRef();
    m_pContext->QueryInterface(IID_IHXCommonClassFactory, (void**)&m_pClassFactory);
    m_pDLLAccess = new DLLAccess();
}
 
// deserializing ctor
HXPluginDLL::HXPluginDLL( IUnknown* pContext,
                         const char* pszMountPoint, 
                         HXPluginArchiveReader& ar)
: m_fpCreateInstance(0)
, m_fpShutdown(0)
, m_fCanUnload(0)
, m_strMountPoint( pszMountPoint )
, m_pluginCount(0)
, m_pDLLAccess(0)
, m_bHasFactory(FALSE)
, m_bLoaded(FALSE)
, m_pContext(0)
{
    DPRINTF(D_INFO, ("HXPluginDLL::HXPluginDLL()\n"));
    Init(pContext);

    HX_ASSERT(!ar.AtEnd());

    ar.Read(m_strFileName);
    ar.Read(m_bHasFactory);
    ar.Read(m_pluginCount);
    HX_ASSERT(m_pluginCount > 0);
    
    DPRINTF(D_INFO, ("HXPluginDLL::HXPluginDLL(): '%s' - %u plugins\n", (const char*)m_strFileName, m_pluginCount));
    for(UINT16 idx = 0; idx < m_pluginCount; ++idx)
    {
	HXPlugin* pPlugin = new HXPlugin(m_pContext, ar);
        if(pPlugin)
        {
            pPlugin->AddRef();
	    HX_RESULT hr = pPlugin->Init(this, idx);
            if(SUCCEEDED(hr))
            {
                m_plugins.AddTail(pPlugin);
            }
        }
    }
    
}

// serialize object
void HXPluginDLL::Archive(HXPluginArchiveWriter& ar)
{
    ar.Write(UINT32(ARCHIVE_ID_PLUGIN_DLL));
    ar.Write(m_strFileName);
    ar.Write(m_bHasFactory);
    ar.Write(m_pluginCount);
  
    for(CHXSimpleList::Iterator iter = m_plugins.Begin(); iter != m_plugins.End(); ++iter)
    {
	HXPlugin* pPlugin = (HXPlugin*) *iter;
        pPlugin->Archive(ar);
    }
    ar.Break();
}




HXPluginDLL::~HXPluginDLL()
{
    DPRINTF(D_INFO, ("HXPluginDLL::~HXPluginDLL()\n"));

    // force DLL to unload
    Unload(true);

    // clear plugins
    CHXSimpleList::Iterator iter = m_plugins.Begin();
    for( ; iter != m_plugins.End(); ++iter)
    {
	HXPlugin* pPlug = (HXPlugin*) *iter;
	pPlug->Release();
    }
    m_plugins.RemoveAll();

    HX_DELETE(m_pDLLAccess);
    HX_RELEASE(m_pContext);
    HX_RELEASE(m_pClassFactory);
}



void HXPluginDLL::AddPlugins(CHXSimpleList& list)
{
    for(CHXSimpleList::Iterator iter = m_plugins.Begin(); iter != m_plugins.End(); ++iter)
    {
	HXPlugin* pPlugin = (HXPlugin*) *iter;
        pPlugin->AddRef();
	list.AddTail(pPlugin);
    }
}

//
// Load() Helper
//
// Instanciate a plugin wrapper for each plugin this dll
// can instanciate. Called after Load().
//
HX_RESULT HXPluginDLL::CreatePlugins()
{
    HX_ASSERT(m_bLoaded);

    DPRINTF(D_INFO, ("HXPluginDLL::CreatePlugins()\n"));

    HX_RESULT hr = HXR_FAIL;
    
    for(UINT16 idx = 0; idx < m_pluginCount; ++idx)
    {
	HXPlugin* pPlugin = new HXPlugin(m_pContext);
	if(!pPlugin)
	{
	    hr = HXR_OUTOFMEMORY;
            break;
	}

	pPlugin->AddRef();
 
        pPlugin->Init(this, idx);
     

	IUnknown* pUnk = NULL;
	if( SUCCEEDED(pPlugin->GetPlugin(pUnk)) )
	{
	    IHXComponentPlugin* pComponentPlugin = NULL;
	    if( SUCCEEDED( pUnk->QueryInterface( IID_IHXComponentPlugin, (void**) &pComponentPlugin ) ) )
	    {
		// We don't need this.
		HX_RELEASE( pPlugin );

		CreateComponentPlugins(pComponentPlugin );
		HX_RELEASE( pComponentPlugin );
	    }
	    else
	    {
		IHXPlugin* pIHXPlugin;
		if( SUCCEEDED( pUnk->QueryInterface(IID_IHXPlugin, (void**)&pIHXPlugin ) ) )
		{
		    pPlugin->GetValuesFromDLL(pIHXPlugin);
		    m_plugins.AddTail(pPlugin);
		    pIHXPlugin->Release();
		}
	    }
	}
        else
        {
            // This plugin doesn't work.  Delete it.
	    HX_RELEASE( pPlugin );
	}
	
	HX_RELEASE( pUnk );
    }

    return hr;
}

//
// CreatePlugins() helper
//
void HXPluginDLL::CreateComponentPlugins( IHXComponentPlugin* pComponentPlugin )
{
    DPRINTF(D_INFO, ("HXPluginManager()::LoadComponentPlugins()\n"));

    IHXPlugin* pIHXPlugin = NULL;
    if( SUCCEEDED( pComponentPlugin->QueryInterface(IID_IHXPlugin, (void**)&pIHXPlugin ) ) )
    {
	for( UINT32 index = 0; index < pComponentPlugin->GetNumComponents(); index++ )
	{
	    IHXValues* pVal = 0;
	    if( SUCCEEDED( pComponentPlugin->GetComponentInfoAtIndex( index, pVal ) ) )
	    {
		// create a new plugin object
		HXPlugin* pPlugin = new HXPlugin( m_pContext );
		HX_ASSERT( pPlugin );

		// Setup plugin object (index is set 0 for component plugins)
		pPlugin->AddRef();
		pPlugin->Init(this, 0);
                pPlugin->AddComponentInfo(pVal); 

		// Put in plugin list
		m_plugins.AddTail(pPlugin);

		HX_RELEASE(pVal);
	    }
	}

	HX_RELEASE (pIHXPlugin);
    }
}


HX_RESULT HXPluginDLL::Load()
{

    DPRINTF(D_INFO, ("HXPluginDLL()::Load()\n"));
    

    HX_ASSERT(m_pContext);
    HX_ASSERT(m_pClassFactory);


    IUnknown*	pInstance   = NULL;
    IHXPlugin* pPlugin = NULL;
    IHXPluginFactory* pIFactory = NULL;

    HX_ASSERT(!m_bLoaded);

    // dll full path
#if !defined(_STATICALLY_LINKED) || defined(HELIX_CONFIG_CONSOLIDATED_CORE)
    // we're not statically linked so we must use the mount point path
    CHXString dllPath = HXPathUtil::CombinePath(m_strMountPoint, m_strFileName);
#else
    CHXString dllPath = m_strFileName;
#endif
    
    DPRINTF(D_INFO, ("HXPluginDLL()::Load(): fullpath = '%s'\n", (const char*)dllPath));

    // load the DLL into memory
    HX_RESULT hr = HXR_FAIL;
    HX_ASSERT(dllPath.GetLength() > 0);
    int dllLoadResult = m_pDLLAccess->open(dllPath);
    if( dllLoadResult != DLLAccess::DLL_OK )
    {
        if ( DLLAccess::OUT_OF_MEMORY == dllLoadResult)
        {
            hr = HXR_OUTOFMEMORY;
        }
        DPRINTF(D_INFO, ("HXPluginDLL()::Load(): dll open failed\n"));
	goto cleanup;
    }

    // HXCreateInstance is required
    m_fpCreateInstance = (FPCREATEINSTANCE) m_pDLLAccess->getSymbol(HXCREATEINSTANCESTR);
    if (NULL == m_fpCreateInstance)
    {
        DPRINTF(D_INFO, ("HXPluginDLL()::Load(): dll missing 'create instance'\n"));
	goto cleanup;
    }

    // HXShutdown not required
    m_fpShutdown    = (FPSHUTDOWN) m_pDLLAccess->getSymbol(HXSHUTDOWNSTR);

    // CanUnload2 not required; CanUnload not used (deprecated)
    m_fCanUnload    = (FPSHUTDOWN) m_pDLLAccess->getSymbol("CanUnload2");

    // CreateInstance() must succeed
    hr = m_fpCreateInstance( &pInstance );
    if( FAILED(hr) )
    {
        DPRINTF(D_INFO, ("HXPluginDLL()::Load(): dll 'create instance' failed\n"));
	goto cleanup;
    }

    
    // A valid plugin must expose IHXPlugin and/or IHXPluginFactory.
    if( SUCCEEDED( pInstance->QueryInterface( IID_IHXPluginFactory, (void**) &pIFactory ) ) )
    {
	m_bHasFactory = TRUE;
	m_pluginCount = pIFactory->GetNumPlugins();
	HX_RELEASE( pIFactory );
    }
    else if( SUCCEEDED( pInstance->QueryInterface( IID_IHXPlugin, (void**) &pPlugin ) ) )
    {
	m_bHasFactory = FALSE;
	m_pluginCount = 1;
	HX_RELEASE( pPlugin );
    }
    else
    {
        hr = HXR_FAIL;
	goto cleanup;
    }

    HX_RELEASE(pInstance);
    m_bLoaded = TRUE;

    // load plugins on first DLL load
    if( m_plugins.GetCount() == 0)
    {
        DPRINTF(D_INFO, ("HXPluginDLL()::Load(): querying dll for plugins...\n"));
        CreatePlugins();
    }

    hr = HXR_OK;

cleanup:

    DPRINTF(D_INFO, ("HXPluginDLL()::Load(): result = 0x%08x\n", hr));
    return hr;
}


HX_RESULT HXPluginDLL::Unload(bool bForce)
{
    DPRINTF(D_INFO, ("HXPluginDLL()::Unload(): is_loaded = %d; force = %d\n", m_bLoaded, bForce));
    
    HX_RESULT hr = HXR_OK;
    if (m_bLoaded)
    {
        hr = HXR_FAIL;
        HX_ASSERT(m_pDLLAccess);
	if (bForce || (m_fCanUnload && m_fCanUnload() == HXR_OK) )
	{
            DPRINTF(D_INFO, ("HXPluginDLL()::Unload(): unloading ('%s')\n", (const char*)m_strFileName));

	    if (m_fpShutdown)
	    {
		m_fpShutdown();
		m_fpShutdown = NULL;
	    }

            m_pDLLAccess->close();
	    m_bLoaded = FALSE;
	    hr = HXR_OK;
	}
    }
    return hr;
}

BOOL HXPluginDLL::IsLoaded()
{
    return m_bLoaded;
}

HX_RESULT HXPluginDLL::CreateInstance(IUnknown** ppUnk, UINT32 uIndex)
{
    DPRINTF(D_INFO, ("HXPluginDLL()::CreateInstance(): '%s': idx = %lu\n", (const char*)m_strFileName, uIndex));
    HX_ASSERT(m_bLoaded);
    HX_RESULT hr = HXR_FAIL;
    if (m_bLoaded)
    {
        if (!m_bHasFactory)
        {
	    hr = m_fpCreateInstance(ppUnk);
        }
        else
        {
            HX_ASSERT( uIndex < m_pluginCount);
	    if (uIndex < m_pluginCount)
            {
	        IUnknown*		pUnk;
	        IHXPluginFactory*	pPluginFactory;

	        m_fpCreateInstance(&pUnk);
                HX_ASSERT(pUnk);
	        hr = pUnk->QueryInterface(IID_IHXPluginFactory, (void**) &pPluginFactory);
                HX_ASSERT(pPluginFactory);
                if(SUCCEEDED(hr))
                {
	            hr = pPluginFactory->GetPlugin((UINT16)uIndex, ppUnk);
                    HX_RELEASE(pPluginFactory);
                }
                HX_RELEASE(pUnk);
            }
        }
    }
    
    return hr;
}





BEGIN_INTERFACE_LIST_NOCREATE(HXOtherDLL)
END_INTERFACE_LIST

// ctor
HXOtherDLL::HXOtherDLL(const char* pszFileName, const char* pszMountPoint)
: m_strFileName(pszFileName)
, m_strMountPoint(pszMountPoint)
{
}

// deserializing ctor
HXOtherDLL::HXOtherDLL(const char* pszMountPoint, HXPluginArchiveReader& ar)
: m_strMountPoint(pszMountPoint)
{
    HX_ASSERT(!ar.AtEnd());
    ar.Read(m_strFileName);
}

// serialize
void HXOtherDLL::Archive(HXPluginArchiveWriter& ar)
{
    ar.Write(UINT32(ARCHIVE_ID_OTHER_DLL));
    ar.Write(m_strFileName);
    ar.Break();
}