mirror of
https://github.com/alliedmodders/metamod-source.git
synced 2024-12-04 16:24:16 +01:00
e19413dd5b
--HG-- rename : sourcemm/IPluginManager.h => core/IPluginManager.h rename : sourcemm/ISmmAPI.h => core/ISmmAPI.h rename : sourcemm/ISmmPlugin.h => core/ISmmPlugin.h rename : sourcemm/ISmmPluginExt.h => core/ISmmPluginExt.h rename : sourcemm/LICENSE.txt => core/LICENSE.txt rename : sourcemm/Makefile => core/Makefile rename : sourcemm/changelog.txt => core/changelog.txt rename : sourcemm/episode1/console.cpp => core/episode1/console.cpp rename : sourcemm/episode1/console.h => core/episode1/console.h rename : sourcemm/episode1/convar_smm.h => core/episode1/convar_smm.h rename : sourcemm/episode1/msvc8/sourcemm.sln => core/episode1/msvc8/sourcemm.sln rename : sourcemm/episode1/msvc8/sourcemm.vcproj => core/episode1/msvc8/sourcemm.vcproj rename : sourcemm/episode1/provider_ep1.cpp => core/episode1/provider_ep1.cpp rename : sourcemm/episode1/provider_ep1.h => core/episode1/provider_ep1.h rename : sourcemm/episode1/vsp_listener.cpp => core/episode1/vsp_listener.cpp rename : sourcemm/episode1/vsp_listener.h => core/episode1/vsp_listener.h rename : sourcemm/metamod.cpp => core/metamod.cpp rename : sourcemm/metamod.h => core/metamod.h rename : sourcemm/metamod_console.cpp => core/metamod_console.cpp rename : sourcemm/metamod_console.h => core/metamod_console.h rename : sourcemm/metamod_oslink.cpp => core/metamod_oslink.cpp rename : sourcemm/metamod_oslink.h => core/metamod_oslink.h rename : sourcemm/metamod_plugins.cpp => core/metamod_plugins.cpp rename : sourcemm/metamod_plugins.h => core/metamod_plugins.h rename : sourcemm/metamod_provider.h => core/metamod_provider.h rename : sourcemm/metamod_util.cpp => core/metamod_util.cpp rename : sourcemm/metamod_util.h => core/metamod_util.h rename : sourcemm/episode2/console.cpp => core/provider/console.cpp rename : sourcemm/episode2/console.h => core/provider/console.h rename : sourcemm/episode2/msvc8/sourcemm.sln => core/provider/msvc8/sourcemm.sln rename : sourcemm/episode2/msvc8/sourcemm.vcproj => core/provider/msvc8/sourcemm.vcproj rename : sourcemm/episode2/msvc9/sourcemm.sln => core/provider/msvc9/sourcemm.sln rename : sourcemm/episode2/msvc9/sourcemm.vcproj => core/provider/msvc9/sourcemm.vcproj rename : sourcemm/episode2/provider_ep2.cpp => core/provider/provider_ep2.cpp rename : sourcemm/episode2/provider_ep2.h => core/provider/provider_ep2.h rename : sourcemm/episode2/vsp_listener.cpp => core/provider/vsp_listener.cpp rename : sourcemm/episode2/vsp_listener.h => core/provider/vsp_listener.h rename : sourcehook/FastDelegate.h => core/sourcehook/FastDelegate.h rename : sourcehook/generate/FastDelegate.h => core/sourcehook/generate/FastDelegate.h rename : sourcehook/generate/FastDelegate.hxx => core/sourcehook/generate/FastDelegate.hxx rename : sourcehook/generate/generate => core/sourcehook/generate/generate rename : sourcehook/generate/generate.bat => core/sourcehook/generate/generate.bat rename : sourcehook/generate/sh_memfuncinfo.h => core/sourcehook/generate/sh_memfuncinfo.h rename : sourcehook/generate/sh_memfuncinfo.hxx => core/sourcehook/generate/sh_memfuncinfo.hxx rename : sourcehook/generate/shworker.bin => core/sourcehook/generate/shworker.bin rename : sourcehook/generate/shworker.exe => core/sourcehook/generate/shworker.exe rename : sourcehook/generate/shworker/Makefile => core/sourcehook/generate/shworker/Makefile rename : sourcehook/generate/shworker/fd_hopter.cpp => core/sourcehook/generate/shworker/fd_hopter.cpp rename : sourcehook/generate/shworker/msvc7/shworker.vcproj => core/sourcehook/generate/shworker/msvc7/shworker.vcproj rename : sourcehook/generate/shworker/msvc8/shworker.vcproj => core/sourcehook/generate/shworker/msvc8/shworker.vcproj rename : sourcehook/generate/shworker/shworker.cpp => core/sourcehook/generate/shworker/shworker.cpp rename : sourcehook/generate/sourcehook.h => core/sourcehook/generate/sourcehook.h rename : sourcehook/generate/sourcehook.hxx => core/sourcehook/generate/sourcehook.hxx rename : sourcehook/sh_list.h => core/sourcehook/sh_list.h rename : sourcehook/sh_memfuncinfo.h => core/sourcehook/sh_memfuncinfo.h rename : sourcehook/sh_memory.h => core/sourcehook/sh_memory.h rename : sourcehook/sh_pagealloc.h => core/sourcehook/sh_pagealloc.h rename : sourcehook/sh_stack.h => core/sourcehook/sh_stack.h rename : sourcehook/sh_string.h => core/sourcehook/sh_string.h rename : sourcehook/sh_tinyhash.h => core/sourcehook/sh_tinyhash.h rename : sourcehook/sh_vector.h => core/sourcehook/sh_vector.h rename : sourcehook/sourcehook.cpp => core/sourcehook/sourcehook.cpp rename : sourcehook/sourcehook.h => core/sourcehook/sourcehook.h rename : sourcehook/sourcehook_hookmangen.cpp => core/sourcehook/sourcehook_hookmangen.cpp rename : sourcehook/sourcehook_hookmangen.h => core/sourcehook/sourcehook_hookmangen.h rename : sourcehook/sourcehook_hookmangen_x86.h => core/sourcehook/sourcehook_hookmangen_x86.h rename : sourcehook/sourcehook_impl.h => core/sourcehook/sourcehook_impl.h rename : sourcehook/sourcehook_impl_chook.h => core/sourcehook/sourcehook_impl_chook.h rename : sourcehook/sourcehook_impl_chookidman.h => core/sourcehook/sourcehook_impl_chookidman.h rename : sourcehook/sourcehook_impl_chookmaninfo.h => core/sourcehook/sourcehook_impl_chookmaninfo.h rename : sourcehook/sourcehook_impl_ciface.h => core/sourcehook/sourcehook_impl_ciface.h rename : sourcehook/sourcehook_impl_cproto.h => core/sourcehook/sourcehook_impl_cproto.h rename : sourcehook/sourcehook_impl_cvfnptr.h => core/sourcehook/sourcehook_impl_cvfnptr.h rename : sourcehook/sourcehook_pibuilder.h => core/sourcehook/sourcehook_pibuilder.h rename : sourcehook/test/Makefile => core/sourcehook/test/Makefile rename : sourcehook/test/generate.bat => core/sourcehook/test/generate.bat rename : sourcehook/test/main.cpp => core/sourcehook/test/main.cpp rename : sourcehook/test/msvc7/test.vcproj => core/sourcehook/test/msvc7/test.vcproj rename : sourcehook/test/msvc8/test.vcproj => core/sourcehook/test/msvc8/test.vcproj rename : sourcehook/test/sourcehook_test.h => core/sourcehook/test/sourcehook_test.h rename : sourcehook/test/test1.cpp => core/sourcehook/test/test1.cpp rename : sourcehook/test/test2.cpp => core/sourcehook/test/test2.cpp rename : sourcehook/test/test3.cpp => core/sourcehook/test/test3.cpp rename : sourcehook/test/test4.cpp => core/sourcehook/test/test4.cpp rename : sourcehook/test/testbail.cpp => core/sourcehook/test/testbail.cpp rename : sourcehook/test/testbail.h => core/sourcehook/test/testbail.h rename : sourcehook/test/testbail2.cpp => core/sourcehook/test/testbail2.cpp rename : sourcehook/test/testevents.h => core/sourcehook/test/testevents.h rename : sourcehook/test/testhookmangen.cpp => core/sourcehook/test/testhookmangen.cpp rename : sourcehook/test/testhookmangen.h => core/sourcehook/test/testhookmangen.h rename : sourcehook/test/testhookmangen.hxx => core/sourcehook/test/testhookmangen.hxx rename : sourcehook/test/testlist.cpp => core/sourcehook/test/testlist.cpp rename : sourcehook/test/testmanual.cpp => core/sourcehook/test/testmanual.cpp rename : sourcehook/test/testmulti.cpp => core/sourcehook/test/testmulti.cpp rename : sourcehook/test/testrecall.cpp => core/sourcehook/test/testrecall.cpp rename : sourcehook/test/testreentr.cpp => core/sourcehook/test/testreentr.cpp rename : sourcehook/test/testref.cpp => core/sourcehook/test/testref.cpp rename : sourcehook/test/testrefret.cpp => core/sourcehook/test/testrefret.cpp rename : sourcehook/test/testvphooks.cpp => core/sourcehook/test/testvphooks.cpp rename : sourcemm/svn_version.h => core/svn_version.h rename : sourcemm/svn_version.tpl => core/svn_version.tpl rename : sourcemm/version.rc => core/version.rc
159 lines
4.5 KiB
C++
159 lines
4.5 KiB
C++
/*
|
|
* vim: set ts=4 :
|
|
* ======================================================
|
|
* Metamod:Source
|
|
* Copyright (C) 2004-2008 AlliedModders LLC and authors.
|
|
* All rights reserved.
|
|
* ======================================================
|
|
*
|
|
* This software is provided 'as-is', without any express or implied warranty.
|
|
* In no event will the authors be held liable for any damages arising from
|
|
* the use of this software.
|
|
*
|
|
* Permission is granted to anyone to use this software for any purpose,
|
|
* including commercial applications, and to alter it and redistribute it
|
|
* freely, subject to the following restrictions:
|
|
*
|
|
* 1. The origin of this software must not be misrepresented; you must not
|
|
* claim that you wrote the original software. If you use this software in a
|
|
* product, an acknowledgment in the product documentation would be
|
|
* appreciated but is not required.
|
|
* 2. Altered source versions must be plainly marked as such, and must not be
|
|
* misrepresented as being the original software.
|
|
* 3. This notice may not be removed or altered from any source distribution.
|
|
*
|
|
* Version: $Id$
|
|
*/
|
|
|
|
#ifndef _INCLUDE_METAMOD_IPLUGINMANAGER_H
|
|
#define _INCLUDE_METAMOD_IPLUGINMANAGER_H
|
|
|
|
/**
|
|
* @brief Plugin Manager interface
|
|
* @file IPluginManager.h
|
|
*/
|
|
|
|
#include <ISmmPluginExt.h>
|
|
|
|
namespace SourceMM
|
|
{
|
|
/**
|
|
* @brief Load sources
|
|
*/
|
|
enum
|
|
{
|
|
Pl_BadLoad=0,
|
|
Pl_Console=-1,
|
|
Pl_File=-2,
|
|
Pl_MinId=1,
|
|
};
|
|
|
|
/**
|
|
* @brief Status of a plugin at runtime
|
|
*/
|
|
enum Pl_Status
|
|
{
|
|
Pl_NotFound=-4,
|
|
Pl_Error=-3,
|
|
Pl_Refused=-2,
|
|
Pl_Paused=-1,
|
|
Pl_Running=0,
|
|
};
|
|
|
|
/**
|
|
* @brief Programmatic management of the "loaded plugin" list.
|
|
*/
|
|
class ISmmPluginManager
|
|
{
|
|
public:
|
|
/**
|
|
* @brief Loads a plugin and returns its id. If this is called before DLLInit(),
|
|
* then the plugin is considered to be "hot" - it might refuse its own load later!
|
|
* Also, a hot plugin might not have an error message.
|
|
*
|
|
* @param file String containing file name.
|
|
* @param source Specifies who loaded the plugin.
|
|
* @param already Whether or not the plugin was already loaded.
|
|
* @param error String buffer for error messages.
|
|
* @param maxlen Maximum length of buffer.
|
|
* @return Id of plugin.
|
|
*/
|
|
virtual PluginId Load(const char *file, PluginId source, bool &already, char *error, size_t maxlen) =0;
|
|
|
|
/**
|
|
* @brief Unloads a plugin.
|
|
*
|
|
* @param id Id of plugin
|
|
* @param force True to forcefully unload, false to let plugin opt-out.
|
|
* @param error String buffer for error messages
|
|
* @param maxlen Maximum length of buffer
|
|
* @return True on success, false otherwise
|
|
*/
|
|
virtual bool Unload(PluginId id, bool force, char *error, size_t maxlen) =0;
|
|
|
|
/**
|
|
* @brief Pauses a plugin
|
|
*
|
|
* @param id Id of plugin
|
|
* @param error String buffer for error messages
|
|
* @param maxlen Maximum length of buffer
|
|
* @return True on success, false otherwise
|
|
*/
|
|
virtual bool Pause(PluginId id, char *error, size_t maxlen) =0;
|
|
|
|
/**
|
|
* @brief Unpauses a plugin
|
|
*
|
|
* @param id Id of plugin
|
|
* @param error String buffer for error messages
|
|
* @param maxlen Maximum length of buffer
|
|
* @return True on success, false otherwise
|
|
*/
|
|
virtual bool Unpause(PluginId id, char *error, size_t maxlen) =0;
|
|
|
|
/**
|
|
* @brief Unloads all plugins forcefully
|
|
*
|
|
* @return True on success, false otherwise
|
|
*/
|
|
virtual bool UnloadAll() =0;
|
|
|
|
/**
|
|
* @brief Returns information about a plugin
|
|
*
|
|
* @param id Id of plugin
|
|
* @param file Pointer to store filename pointer, or NULL to ignore.
|
|
* @param status Pointer to store status, or NULL to ignore.
|
|
* @param source Pointer to store source, or NULL to ignore.
|
|
* @return True on success, false if not found
|
|
*/
|
|
virtual bool Query(PluginId id, const char **file, Pl_Status *status, PluginId *source) =0;
|
|
|
|
/**
|
|
* @brief Checks another plugin's QueryRunning() status.
|
|
*
|
|
* @param id Id of plugin
|
|
* @param error Message buffer
|
|
* @param maxlength Size of error buffer
|
|
* @return Status value
|
|
*/
|
|
virtual bool QueryRunning(PluginId id, char *error, size_t maxlength) =0;
|
|
|
|
/**
|
|
* @brief Returns the handle of a plugin (OS dependent meaning)
|
|
*
|
|
* @param id Id of plugin
|
|
* @param handle Pointer to store handle pointer, or NULL to ignore.
|
|
* @return True if plugin id is valid, false otherwise
|
|
*/
|
|
virtual bool QueryHandle(PluginId id, void **handle) =0;
|
|
};
|
|
}
|
|
|
|
#if !defined METAMOD_NO_AUTO_NAMESPACE
|
|
using namespace SourceMM;
|
|
#endif
|
|
|
|
#endif //_INCLUDE_PLUGINMANAGER_H
|
|
|