|
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@42
|
73 |
void RemoveCallClassPatch(CallClassInfo &cc, int vtbl_offs, int vtbl_idx); |
|
pavolmarko@1
|
74 |
|
|
pavolmarko@1
|
75 |
META_RES m_Status, m_PrevRes, m_CurRes; |
|
pavolmarko@1
|
76 |
const void *m_OrigRet; |
|
pavolmarko@1
|
77 |
const void *m_OverrideRet; |
|
pavolmarko@1
|
78 |
void *m_IfacePtr; |
|
pavolmarko@1
|
79 |
public: |
|
pavolmarko@1
|
80 |
CSourceHookImpl(); |
|
pavolmarko@1
|
81 |
~CSourceHookImpl(); |
|
pavolmarko@1
|
82 |
|
|
pavolmarko@1
|
83 |
/** |
|
pavolmarko@6
|
84 |
* @brief Make sure that a plugin is not used by any other plugins anymore, and unregister all its hook managers |
|
pavolmarko@1
|
85 |
*/ |
|
pavolmarko@1
|
86 |
void UnloadPlugin(Plugin plug); |
|
pavolmarko@1
|
87 |
|
|
pavolmarko@1
|
88 |
/** |
|
pavolmarko@6
|
89 |
* @brief Shut down the whole system, unregister all hook managers |
|
pavolmarko@1
|
90 |
*/ |
|
pavolmarko@1
|
91 |
void CompleteShutdown(); |
|
pavolmarko@1
|
92 |
|
|
pavolmarko@1
|
93 |
/** |
|
pavolmarko@1
|
94 |
* @brief Add a hook. |
|
pavolmarko@1
|
95 |
* |
|
pavolmarko@1
|
96 |
* @return True if the function succeeded, false otherwise |
|
pavolmarko@1
|
97 |
* |
|
pavolmarko@1
|
98 |
* @param plug The unique identifier of the plugin that calls this function |
|
pavolmarko@1
|
99 |
* @param iface The interface pointer |
|
pavolmarko@6
|
100 |
* @param ifacesize The size of the class iface points to |
|
pavolmarko@6
|
101 |
* @param myHookMan A hook manager function that should be capable of handling the function |
|
pavolmarko@1
|
102 |
* @param handler A pointer to a FastDelegate containing the hook handler |
|
pavolmarko@1
|
103 |
* @param post Set to true if you want a post handler |
|
pavolmarko@1
|
104 |
*/ |
|
pavolmarko@41
|
105 |
bool AddHook(Plugin plug, void *iface, int thisptr_offs, HookManagerPubFunc myHookMan, ISHDelegate *handler, bool post); |
|
pavolmarko@1
|
106 |
|
|
pavolmarko@1
|
107 |
/** |
|
pavolmarko@1
|
108 |
* @brief Removes a hook. |
|
pavolmarko@1
|
109 |
* |
|
pavolmarko@1
|
110 |
* @return True if the function succeeded, false otherwise |
|
pavolmarko@1
|
111 |
* |
|
pavolmarko@1
|
112 |
* @param plug The unique identifier of the plugin that calls this function |
|
pavolmarko@1
|
113 |
* @param iface The interface pointer |
|
pavolmarko@41
|
114 |
* @param thisptr_offs This pointer adjuster |
|
pavolmarko@41
|
115 |
* @param myHookMan A hook manager function that should be capable of handling the function |
|
pavolmarko@41
|
116 |
* @param handler A pointer to a FastDelegate containing the hook handler |
|
pavolmarko@41
|
117 |
* @param post Set to true if you want a post handler |
|
pavolmarko@41
|
118 |
*/ |
|
pavolmarko@41
|
119 |
bool RemoveHook(Plugin plug, void *iface, int thisptr_offs, HookManagerPubFunc myHookMan, ISHDelegate *handler, bool post); |
|
pavolmarko@41
|
120 |
|
|
pavolmarko@41
|
121 |
/** |
|
pavolmarko@41
|
122 |
* @brief Removes a hook. |
|
pavolmarko@41
|
123 |
* |
|
pavolmarko@41
|
124 |
* @return True if the function succeeded, false otherwise |
|
pavolmarko@41
|
125 |
* |
|
pavolmarko@41
|
126 |
* @param plug The unique identifier of the plugin that calls this function |
|
pavolmarko@41
|
127 |
* @param iface Already adjusted interface pointer |
|
pavolmarko@6
|
128 |
* @param myHookMan A hook manager function that should be capable of handling the function |
|
pavolmarko@1
|
129 |
* @param handler A pointer to a FastDelegate containing the hook handler |
|
pavolmarko@1
|
130 |
* @param post Set to true if you want a post handler |
|
pavolmarko@1
|
131 |
*/ |
|
pavolmarko@6
|
132 |
bool RemoveHook(Plugin plug, void *iface, HookManagerPubFunc myHookMan, ISHDelegate *handler, bool post); |
|
pavolmarko@1
|
133 |
|
|
pavolmarko@1
|
134 |
/** |
|
pavolmarko@41
|
135 |
* @brief Removes a hook. |
|
pavolmarko@41
|
136 |
* |
|
pavolmarko@41
|
137 |
* @ return True if the function succeeded, false otherwise |
|
pavolmarko@41
|
138 |
* |
|
pavolmarko@41
|
139 |
* @param info A RemoveHookInfo structure, describing the hook |
|
pavolmarko@41
|
140 |
*/ |
|
pavolmarko@41
|
141 |
bool RemoveHook(RemoveHookInfo info); |
|
pavolmarko@41
|
142 |
|
|
pavolmarko@41
|
143 |
/** |
|
pavolmarko@6
|
144 |
* @brief Checks whether a plugin has (a) hook manager(s) that is/are currently used by other plugins |
|
pavolmarko@1
|
145 |
* |
|
pavolmarko@1
|
146 |
* @param plug The unique identifier of the plugin in question |
|
pavolmarko@1
|
147 |
*/ |
|
pavolmarko@1
|
148 |
bool IsPluginInUse(Plugin plug); |
|
pavolmarko@1
|
149 |
|
|
pavolmarko@1
|
150 |
/** |
|
pavolmarko@8
|
151 |
* @brief Pauses all hooks of a plugin |
|
pavolmarko@8
|
152 |
* |
|
pavolmarko@8
|
153 |
* @param plug The unique identifier of the plugin |
|
pavolmarko@8
|
154 |
*/ |
|
pavolmarko@8
|
155 |
void PausePlugin(Plugin plug); |
|
pavolmarko@8
|
156 |
|
|
pavolmarko@8
|
157 |
/** |
|
pavolmarko@8
|
158 |
* @brief Unpauses all hooks of a plugin |
|
pavolmarko@8
|
159 |
* |
|
pavolmarko@8
|
160 |
* @param plug The unique identifier of the plugin |
|
pavolmarko@8
|
161 |
*/ |
|
pavolmarko@8
|
162 |
void UnpausePlugin(Plugin plug); |
|
pavolmarko@8
|
163 |
|
|
pavolmarko@8
|
164 |
/** |
|
pavolmarko@1
|
165 |
* @brief Return a pointer to a callclass. Generate a new one if required. |
|
pavolmarko@1
|
166 |
* |
|
pavolmarko@1
|
167 |
* @param iface The interface pointer |
|
pavolmarko@1
|
168 |
*/ |
|
pavolmarko@41
|
169 |
GenericCallClass *GetCallClass(void *iface); |
|
pavolmarko@1
|
170 |
|
|
pavolmarko@1
|
171 |
/** |
|
pavolmarko@1
|
172 |
* @brief Release a callclass |
|
pavolmarko@1
|
173 |
* |
|
pavolmarko@1
|
174 |
* @param ptr Pointer to the callclass |
|
pavolmarko@1
|
175 |
*/ |
|
pavolmarko@41
|
176 |
virtual void ReleaseCallClass(GenericCallClass *ptr); |
|
pavolmarko@1
|
177 |
|
|
pavolmarko@1
|
178 |
virtual void SetRes(META_RES res); //!< Sets the meta result |
|
pavolmarko@1
|
179 |
virtual META_RES GetPrevRes(); //!< Gets the meta result of the previously called handler |
|
pavolmarko@1
|
180 |
virtual META_RES GetStatus(); //!< Gets the highest meta result |
|
pavolmarko@1
|
181 |
virtual const void *GetOrigRet(); //!< Gets the original result. If not in post function, undefined |
|
pavolmarko@1
|
182 |
virtual const void *GetOverrideRet(); //!< Gets the override result. If none is specified, NULL |
|
pavolmarko@1
|
183 |
virtual void *GetIfacePtr(); //!< Gets the interface pointer |
|
pavolmarko@1
|
184 |
|
|
pavolmarko@1
|
185 |
////////////////////////////////////////////////////////////////////////// |
|
pavolmarko@6
|
186 |
// For hook managers |
|
pavolmarko@1
|
187 |
virtual META_RES &GetCurResRef(); //!< Gets the pointer to the current meta result |
|
pavolmarko@1
|
188 |
virtual META_RES &GetPrevResRef(); //!< Gets the pointer to the previous meta result |
|
pavolmarko@1
|
189 |
virtual META_RES &GetStatusRef(); //!< Gets the pointer to the status variable |
|
pavolmarko@1
|
190 |
virtual void SetOrigRet(const void *ptr); //!< Sets the original return pointer |
|
pavolmarko@1
|
191 |
virtual void SetOverrideRet(const void *ptr); //!< Sets the override result pointer |
|
pavolmarko@1
|
192 |
virtual void SetIfacePtr(void *ptr); //!< Sets the interface this pointer |
|
pavolmarko@1
|
193 |
}; |
|
pavolmarko@1
|
194 |
} |
|
pavolmarko@1
|
195 |
|
|
dvander@34
|
196 |
#endif |
|
dvander@34
|
197 |
|