- multi_platform_plugin_spl_demo.zip
- builds
- dotnet2003
- linux
- vc6
- libspl.dsp
- libspl.dsw
- code
- documents
- examples
- bin
- ConsoleTest.exe
- MfcPluginDllTest.exe
- MFCPluginTest.exe
- MfcThreadPluginTest.exe
- spl.dll
- StartConsoleTest.bat
- builds
- ConsoleTest
- examples.sln
- MfcPluginDllTest
- MfcPluginTest
- MfcThreadPluginTest
- plArgInfos
- plHelloWorld
- plHelloWorldNoMacros
- plReverse
- plReverseSlow
- plToLower
- plToUpper
- obj
- plugins
- plArgInfos.dll
- plHelloWorld.dll
- plHelloWorldNoMacros.dll
- plReverse.dll
- plReverseSlow.dll
- plToLower.dll
- plToUpper.dll
- history.txt
- lib
- dll
- spl.dll
- spl.lib
- spld.dll
- spld.lib
- libspl.lib
- libspld.lib
- license.txt
- obj
- readme.txt
|
/*!
\section terms_of_use Terms of Use
libspl - the simple plugin layer library.
Copyright (C) 2004 Andreas Loeffler and Ren� Stuhr (www.unitedbytes.de).
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
\section author Author
Andreas Loeffler (www.unitedbytes.de)
*/
//---------------------------------------------------------------------------------------------------------------------------
/// @file spl_pluginserver_linux.h
/// @version 1.0
/// @brief The plugin server's linux implementation.
/// @author Andreas Loeffler
//---------------------------------------------------------------------------------------------------------------------------
#ifndef __SPL_PLUGINSERVER_LINUX_H__
#define __SPL_PLUGINSERVER_LINUX_H__
#ifndef __SPL_PLUGINSERVER_H__
#include "spl_pluginserver.h"
#endif
namespace SPL
{
//---------------------------------------------------------------------------------------------------------------------------
/// @brief Plugin server class for linux and other POSIX-based systems.
/// @ingroup SPL
//---------------------------------------------------------------------------------------------------------------------------
class slcPluginServer : public slaPluginServer
{
//
//-----------------------------------------------------------------------------------------------------------------------
//*********************************************** CON/DESTRUCTION ***********************************************
//-----------------------------------------------------------------------------------------------------------------------
//
public:
//-----------------------------------------------------------------------------------------------------------------------
/// @brief Default constructor.
//-----------------------------------------------------------------------------------------------------------------------
slcPluginServer( void );
//-----------------------------------------------------------------------------------------------------------------------
/// @brief Default destructor.
//-----------------------------------------------------------------------------------------------------------------------
virtual ~slcPluginServer( void );
//
//-----------------------------------------------------------------------------------------------------------------------
//************************************************ MODIFICATION *************************************************
//-----------------------------------------------------------------------------------------------------------------------
//
public:
//-----------------------------------------------------------------------------------------------------------------------
/// @brief Retrieves information about one loaded plugin.
//-----------------------------------------------------------------------------------------------------------------------
virtual slcPluginInfo GetPluginInfo( const long a_lIndex );
//-----------------------------------------------------------------------------------------------------------------------
/// @brief Automatically retrieves information about all loaded plugins.
//-----------------------------------------------------------------------------------------------------------------------
virtual void GetAllPluginInfos( void );
//-----------------------------------------------------------------------------------------------------------------------
/// @brief Loads all plugins with a given wildcard in a specified path.
/// @param a_strPath [in] Valid path for searching the plugins.
/// @param a_strWildcard [in] File wildcard (e.g. *.*, *.dll) for the plugins.
/// @param a_pPluginArgs [in] Pointer to arguments for initializing all plugins after they have been loaded.
/// @return Number of successfully loaded plugins.
//-----------------------------------------------------------------------------------------------------------------------
virtual long LoadAllPlugins( const string& a_strPath,
const string& a_strWildcard,
const slcPluginArgs* a_pPluginArgs = NULL );
//-----------------------------------------------------------------------------------------------------------------------
/// @brief Loads a plugin with the specified file name.
/// @param a_strFileName [in] The plugin's file name.
/// @param a_pPluginArgs [in] Pointer to plugin's start function arguments.
/// @return The method returns one of the following values:
/// @retval -2 | Plugin was not found.
/// @retval -1 | Plugin's initialize function was not found.
/// @retval 0 | Error while executing the intialisation function.
/// @retval 1 | Plugin was successfully loaded.
//-----------------------------------------------------------------------------------------------------------------------
virtual long LoadPlugin( const string& a_strFileName, const slcPluginArgs* a_pPluginArgs = NULL );
//-----------------------------------------------------------------------------------------------------------------------
/// @brief Unloads a plugin with the given index (0-based).
/// @param a_lIndex [in] The plugin's index.
/// @param a_pPluginArgs [in] Pointer to plugin's shutdown function arguments.
/// @return The method returns one of the following values:
/// @retval true | The plugin was unloaded successfully.
/// @retval false | Could not unload plugin.
//-----------------------------------------------------------------------------------------------------------------------
virtual bool UnloadPlugin( const long a_lIndex, const slcPluginArgs* a_pPluginArgs = NULL );
//-----------------------------------------------------------------------------------------------------------------------
/// @brief Unloads all plugins.
/// @param a_pPluginArgs [in] Arguments for shutting down all plugins after they have been unloaded.
//-----------------------------------------------------------------------------------------------------------------------
virtual void UnloadAllPlugins( const slcPluginArgs* a_pPluginArgs = NULL );
//-----------------------------------------------------------------------------------------------------------------------
/// @brief Runs a plugin with the given index (0-based) and arguments.
/// @param a_lIndex [in] The plugin's index.
/// @param a_pPluginArgs [in] Pointer to plugin's run function arguments.
/// @return The method returns one of the following values:
/// @retval true | The plugin execution was successful.
/// @retval false | An error occured while executing the plugin.
//-----------------------------------------------------------------------------------------------------------------------
virtual bool RunPlugin( const long a_lIndex, const slcPluginArgs* a_pPluginArgs = NULL );
//-----------------------------------------------------------------------------------------------------------------------
/// @brief Runs all plugins with the given arguments.
/// @param a_pPluginArgs [in] Pointer to plugin's run function arguments.
/// @return Number of successfully executed plugins.
//-----------------------------------------------------------------------------------------------------------------------
virtual long RunAllPlugins( const slcPluginArgs* a_pPluginArgs = NULL );
//-----------------------------------------------------------------------------------------------------------------------
/// @brief Unloads all plugins and looks for new plugins in the given path.
/// @param a_strPath [in] Valid path for searching the plugins.
/// @param a_strWildcard [in] File wildcard (e.g. *.*, *.dll) for the plugins.
/// @param a_pPluginShutdownArgs [in] Pointer to arguments for shutting down all plugins before they will be unloaded.
/// @param a_pPluginInitArgs [in] Pointer to arguments for initializing all plugins after they have been loaded.
/// @return Number of successfully loaded plugins.
//-----------------------------------------------------------------------------------------------------------------------
virtual long Refresh( const string& a_strPath,
const string& a_strWildcard,
const slcPluginArgs* a_pPluginShutdownArgs = NULL,
const slcPluginArgs* a_pPluginInitArgs = NULL );
};
} // End of namespace SPL
using namespace SPL;
#endif // __SPL_PLUGINSERVER_H__
|
By viewing downloads associated with this article you agree to the Terms of Service and the article's licence.
If a file you wish to view isn't highlighted, and is a text file (not binary), please
let us know and we'll add colourisation support for it.
This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.
A list of licenses authors might use can be found here
I was born in 1982 near Stuttgart / Germany and began my first steps in programming computers at the age of only nine years on an old Commodore CBM 7072. In 2002 I finished my education as IT specialist for software engineering and did my civillian service afterwards. Currently I'm working as leader of the software division in a bigger company located in south west Germany, mainly on software development and research projects for multimedia terminals and user recognition/verification systems.