sourcehook/sourcehook_impl.h
author Pavol Marko <pavolmarko@gmail.com>
Fri Apr 29 20:29:46 2005 +0000 (2005-04-29)
changeset 41 534eac4c53ef
parent 34 11e62a912700
child 42 390a2aec00e4
permissions -rw-r--r--
Completly redone templates, added "vfnptrs"
pavolmarko@1
     1
/* ======== SourceHook ========
dvander@10
     2
* Copyright (C) 2004-2005 Metamod:Source Development Team
pavolmarko@1
     3
* No warranties of any kind
pavolmarko@1
     4
*
dvander@10
     5
* License: zlib/libpng
dvander@10
     6
*
dvander@10
     7
* Author(s): Pavol "PM OnoTo" Marko
pavolmarko@1
     8
* ============================
pavolmarko@1
     9
*/
pavolmarko@1
    10
pavolmarko@1
    11
#ifndef __SOURCEHOOK_IMPL_H__
pavolmarko@1
    12
#define __SOURCEHOOK_IMPL_H__
pavolmarko@1
    13
pavolmarko@1
    14
#include "sourcehook.h"
pavolmarko@1
    15
pavolmarko@1
    16
// Set this to 1 to enable runtime code generation (faster)
pavolmarko@1
    17
#define SH_RUNTIME_CODEGEN 1
pavolmarko@1
    18
pavolmarko@1
    19
namespace SourceHook
pavolmarko@1
    20
{
pavolmarko@1
    21
	/**
pavolmarko@1
    22
	*	@brief The SourceHook implementation class
pavolmarko@1
    23
	*/
pavolmarko@1
    24
	class CSourceHookImpl : public ISourceHook
pavolmarko@1
    25
	{
pavolmarko@1
    26
		/**
pavolmarko@6
    27
		*	@brief A hook can be removed if you have this information
pavolmarko@1
    28
		*/
pavolmarko@6
    29
		struct RemoveHookInfo
pavolmarko@6
    30
		{
pavolmarko@41
    31
			RemoveHookInfo(Plugin pplug, void *piface, HookManagerPubFunc phookman,
pavolmarko@41
    32
				ISHDelegate *phandler, bool ppost)
pavolmarko@41
    33
				: plug(pplug), iface(piface), hookman(phookman), handler(phandler), post(ppost)
pavolmarko@6
    34
			{
pavolmarko@6
    35
			}
pavolmarko@6
    36
pavolmarko@6
    37
			Plugin plug;
pavolmarko@6
    38
			void *iface;
pavolmarko@41
    39
			HookManagerPubFunc hookman;
pavolmarko@6
    40
			ISHDelegate *handler;
pavolmarko@6
    41
			bool post;
pavolmarko@6
    42
		};
pavolmarko@6
    43
pavolmarko@6
    44
		/**
pavolmarko@6
    45
		*	@brief A list of HookManagerInfo structures
pavolmarko@6
    46
		*/
pavolmarko@6
    47
		typedef std::list<HookManagerInfo> HookManInfoList;
pavolmarko@1
    48
pavolmarko@41
    49
		struct CallClassInfo
pavolmarko@41
    50
		{
pavolmarko@41
    51
			GenericCallClass cc;
pavolmarko@41
    52
			int refcounter;
pavolmarko@41
    53
			bool operator==(void *other)
pavolmarko@41
    54
			{
pavolmarko@41
    55
				return cc.ptr == other;
pavolmarko@41
    56
			}
pavolmarko@41
    57
		};
pavolmarko@1
    58
		/**
pavolmarko@41
    59
		*	@brief A list of CallClass structures
pavolmarko@1
    60
		*/
pavolmarko@41
    61
		typedef std::list<CallClassInfo> Impl_CallClassList;
pavolmarko@1
    62
pavolmarko@1
    63
		Impl_CallClassList m_CallClasses;			//!< A list of already generated callclasses
pavolmarko@6
    64
		HookManInfoList m_HookMans;					//!< A list of hook managers
pavolmarko@1
    65
pavolmarko@1
    66
		/**
pavolmarko@6
    67
		*	@brief Finds a hook manager for a function based on a text-prototype, a vtable offset and a vtable index
pavolmarko@1
    68
		*/
pavolmarko@6
    69
		HookManInfoList::iterator FindHookMan(HookManInfoList::iterator begin, HookManInfoList::iterator end, 
pavolmarko@41
    70
			const char *proto, int vtblofs, int vtblidx);
pavolmarko@1
    71
pavolmarko@41
    72
		void ApplyCallClassPatch(CallClassInfo &cc, int vtbl_offs, int vtbl_idx, void *orig_entry);
pavolmarko@1
    73
pavolmarko@1
    74
		META_RES m_Status, m_PrevRes, m_CurRes;
pavolmarko@1
    75
		const void *m_OrigRet;
pavolmarko@1
    76
		const void *m_OverrideRet;
pavolmarko@1
    77
		void *m_IfacePtr;
pavolmarko@1
    78
	public:
pavolmarko@1
    79
		CSourceHookImpl();
pavolmarko@1
    80
		~CSourceHookImpl();
pavolmarko@1
    81
pavolmarko@1
    82
		/**
pavolmarko@6
    83
		*	@brief Make sure that a plugin is not used by any other plugins anymore, and unregister all its hook managers
pavolmarko@1
    84
		*/
pavolmarko@1
    85
		void UnloadPlugin(Plugin plug);
pavolmarko@1
    86
pavolmarko@1
    87
		/**
pavolmarko@6
    88
		*	@brief Shut down the whole system, unregister all hook managers
pavolmarko@1
    89
		*/
pavolmarko@1
    90
		void CompleteShutdown();
pavolmarko@1
    91
pavolmarko@1
    92
		/**
pavolmarko@1
    93
		*	@brief Add a hook.
pavolmarko@1
    94
		*
pavolmarko@1
    95
		*	@return True if the function succeeded, false otherwise
pavolmarko@1
    96
		*
pavolmarko@1
    97
		*	@param plug The unique identifier of the plugin that calls this function
pavolmarko@1
    98
		*	@param iface The interface pointer
pavolmarko@6
    99
		*	@param ifacesize The size of the class iface points to
pavolmarko@6
   100
		*	@param myHookMan A hook manager function that should be capable of handling the function
pavolmarko@1
   101
		*	@param handler A pointer to a FastDelegate containing the hook handler
pavolmarko@1
   102
		*	@param post Set to true if you want a post handler
pavolmarko@1
   103
		*/
pavolmarko@41
   104
		bool AddHook(Plugin plug, void *iface, int thisptr_offs, HookManagerPubFunc myHookMan, ISHDelegate *handler, bool post);
pavolmarko@1
   105
pavolmarko@1
   106
		/**
pavolmarko@1
   107
		*	@brief Removes a hook.
pavolmarko@1
   108
		*
pavolmarko@1
   109
		*	@return True if the function succeeded, false otherwise
pavolmarko@1
   110
		*
pavolmarko@1
   111
		*	@param plug The unique identifier of the plugin that calls this function
pavolmarko@1
   112
		*	@param iface The interface pointer
pavolmarko@41
   113
		*	@param thisptr_offs This pointer adjuster
pavolmarko@41
   114
		*	@param myHookMan A hook manager function that should be capable of handling the function
pavolmarko@41
   115
		*	@param handler A pointer to a FastDelegate containing the hook handler
pavolmarko@41
   116
		*	@param post Set to true if you want a post handler
pavolmarko@41
   117
		*/
pavolmarko@41
   118
		bool RemoveHook(Plugin plug, void *iface, int thisptr_offs, HookManagerPubFunc myHookMan, ISHDelegate *handler, bool post);
pavolmarko@41
   119
pavolmarko@41
   120
		/**
pavolmarko@41
   121
		*	@brief Removes a hook.
pavolmarko@41
   122
		*
pavolmarko@41
   123
		*	@return True if the function succeeded, false otherwise
pavolmarko@41
   124
		*
pavolmarko@41
   125
		*	@param plug The unique identifier of the plugin that calls this function
pavolmarko@41
   126
		*	@param iface Already adjusted interface pointer
pavolmarko@6
   127
		*	@param myHookMan A hook manager function that should be capable of handling the function
pavolmarko@1
   128
		*	@param handler A pointer to a FastDelegate containing the hook handler
pavolmarko@1
   129
		*	@param post Set to true if you want a post handler
pavolmarko@1
   130
		*/
pavolmarko@6
   131
		bool RemoveHook(Plugin plug, void *iface, HookManagerPubFunc myHookMan, ISHDelegate *handler, bool post);
pavolmarko@1
   132
pavolmarko@1
   133
		/**
pavolmarko@41
   134
		*	@brief Removes a hook.
pavolmarko@41
   135
		*
pavolmarko@41
   136
		*	@ return True if the function succeeded, false otherwise
pavolmarko@41
   137
		*
pavolmarko@41
   138
		*	@param info A RemoveHookInfo structure, describing the hook
pavolmarko@41
   139
		*/
pavolmarko@41
   140
		bool RemoveHook(RemoveHookInfo info);
pavolmarko@41
   141
pavolmarko@41
   142
		/**
pavolmarko@6
   143
		*	@brief Checks whether a plugin has (a) hook manager(s) that is/are currently used by other plugins
pavolmarko@1
   144
		*
pavolmarko@1
   145
		*	@param plug The unique identifier of the plugin in question
pavolmarko@1
   146
		*/
pavolmarko@1
   147
		bool IsPluginInUse(Plugin plug);
pavolmarko@1
   148
pavolmarko@1
   149
		/**
pavolmarko@8
   150
		*	@brief Pauses all hooks of a plugin
pavolmarko@8
   151
		*
pavolmarko@8
   152
		*	@param plug The unique identifier of the plugin
pavolmarko@8
   153
		*/
pavolmarko@8
   154
		void PausePlugin(Plugin plug);
pavolmarko@8
   155
pavolmarko@8
   156
		/**
pavolmarko@8
   157
		*	@brief Unpauses all hooks of a plugin
pavolmarko@8
   158
		*
pavolmarko@8
   159
		*	@param plug The unique identifier of the plugin
pavolmarko@8
   160
		*/
pavolmarko@8
   161
		void UnpausePlugin(Plugin plug);
pavolmarko@8
   162
pavolmarko@8
   163
		/**
pavolmarko@1
   164
		*	@brief Return a pointer to a callclass. Generate a new one if required.
pavolmarko@1
   165
		*
pavolmarko@1
   166
		*	@param iface The interface pointer
pavolmarko@1
   167
		*/
pavolmarko@41
   168
		GenericCallClass *GetCallClass(void *iface);
pavolmarko@1
   169
pavolmarko@1
   170
		/**
pavolmarko@1
   171
		*	@brief Release a callclass
pavolmarko@1
   172
		*
pavolmarko@1
   173
		*	@param ptr Pointer to the callclass
pavolmarko@1
   174
		*/
pavolmarko@41
   175
		virtual void ReleaseCallClass(GenericCallClass *ptr);
pavolmarko@1
   176
pavolmarko@1
   177
		virtual void SetRes(META_RES res);				//!< Sets the meta result
pavolmarko@1
   178
		virtual META_RES GetPrevRes();					//!< Gets the meta result of the previously called handler
pavolmarko@1
   179
		virtual META_RES GetStatus();					//!< Gets the highest meta result
pavolmarko@1
   180
		virtual const void *GetOrigRet();				//!< Gets the original result. If not in post function, undefined
pavolmarko@1
   181
		virtual const void *GetOverrideRet();			//!< Gets the override result. If none is specified, NULL
pavolmarko@1
   182
		virtual void *GetIfacePtr();					//!< Gets the interface pointer
pavolmarko@1
   183
pavolmarko@1
   184
		//////////////////////////////////////////////////////////////////////////
pavolmarko@6
   185
		// For hook managers
pavolmarko@1
   186
		virtual META_RES &GetCurResRef();				//!< Gets the pointer to the current meta result
pavolmarko@1
   187
		virtual META_RES &GetPrevResRef();				//!< Gets the pointer to the previous meta result
pavolmarko@1
   188
		virtual META_RES &GetStatusRef();				//!< Gets the pointer to the status variable
pavolmarko@1
   189
		virtual void SetOrigRet(const void *ptr);		//!< Sets the original return pointer
pavolmarko@1
   190
		virtual void SetOverrideRet(const void *ptr);	//!< Sets the override result pointer
pavolmarko@1
   191
		virtual void SetIfacePtr(void *ptr);			//!< Sets the interface this pointer
pavolmarko@1
   192
	};
pavolmarko@1
   193
}
pavolmarko@1
   194
dvander@34
   195
#endif
dvander@34
   196