Difference between revisions of "Studio:Delegating ISHELL SendEvent"
m (Text replace - 'Category:Intercept Modules' to 'Category:Studio:Intercept Modules') |
|||
| (12 intermediate revisions by 3 users not shown) | |||
| Line 2: | Line 2: | ||
Delegating the user's call to the IShell helper macro ISHELL_SendEvent is a better method. ISHELL_SendEvent is defined in AEEShell.h as follows:<br> | Delegating the user's call to the IShell helper macro ISHELL_SendEvent is a better method. ISHELL_SendEvent is defined in AEEShell.h as follows:<br> | ||
| − | + | <Source lang="c"> | |
| − | + | #define ISHELL_SendEvent(p,cls,ec,wp,dw) | |
| + | GET_PVTBL(p,IShell)->SendEvent(p,0,cls,ec,wp,dw) | ||
| + | </Source> | ||
This requires a small amount of instrumentation to the calling application, essentially to define the Group ID and include IM.h. You must also complete the following steps:<br> | This requires a small amount of instrumentation to the calling application, essentially to define the Group ID and include IM.h. You must also complete the following steps:<br> | ||
<ol> | <ol> | ||
<li>Ensure that the calling application is using the helper macro to call the Send event.</li> | <li>Ensure that the calling application is using the helper macro to call the Send event.</li> | ||
| − | <li>Add the following code to the AEEShell.h file | + | <li>Add the following code to the AEEShell.h file inside of the #ifdef _SCL conditional block:</li> |
| − | + | <source lang="c"> | |
| − | + | #undef ISHELL_SendEvent | |
| − | + | int ISHELL_SendEvent(IShell *po, AEECLSID cls, AEEEvent eCode, uint16 wParam, uint32 dwParam); | |
| − | + | #pragma scl_function(ISHELL_SendEvent, "REFERENCE", "IMPLICIT", <groupid-name>) | |
| − | <li> | + | #pragma scl_ptr_opaque(ISHELL_SendEvent,po) |
| + | </source> | ||
| + | <li>Generate ''remote interceptor'' (formal ''dynamic delegate'') for the function ISHELL_SendEvent:</li> | ||
| + | <pre> | ||
| + | > s2sinstrument --mode=PIT(ISHELL_SendEvent) ... | ||
| + | </pre> | ||
<li>Add the instrumentation to the calling application's code:</li> | <li>Add the instrumentation to the calling application's code:</li> | ||
| − | + | <source lang="c"> | |
| − | + | #define <groupid-name> | |
| − | + | #include <name>IM.h | |
| − | + | </source> | |
This allows you to dynamically intercept the call for the application under test. | This allows you to dynamically intercept the call for the application under test. | ||
| + | |||
| + | [[Category:Studio:Intercept Modules]] | ||
Latest revision as of 09:42, 21 August 2009
When trying to dynamically intercept a call for the application under test, intercepting only the call/method of interest was difficult when delegating the IShell Virtual Table, as it allows all methods to be intercepted for all callers.
Delegating the user's call to the IShell helper macro ISHELL_SendEvent is a better method. ISHELL_SendEvent is defined in AEEShell.h as follows:
#define ISHELL_SendEvent(p,cls,ec,wp,dw)
GET_PVTBL(p,IShell)->SendEvent(p,0,cls,ec,wp,dw)
This requires a small amount of instrumentation to the calling application, essentially to define the Group ID and include IM.h. You must also complete the following steps:
- Ensure that the calling application is using the helper macro to call the Send event.
- Add the following code to the AEEShell.h file inside of the #ifdef _SCL conditional block:
- Generate remote interceptor (formal dynamic delegate) for the function ISHELL_SendEvent:
- Add the instrumentation to the calling application's code:
#undef ISHELL_SendEvent
int ISHELL_SendEvent(IShell *po, AEECLSID cls, AEEEvent eCode, uint16 wParam, uint32 dwParam);
#pragma scl_function(ISHELL_SendEvent, "REFERENCE", "IMPLICIT", <groupid-name>)
#pragma scl_ptr_opaque(ISHELL_SendEvent,po)
> s2sinstrument --mode=PIT(ISHELL_SendEvent) ...
#define <groupid-name>
#include <name>IM.h
This allows you to dynamically intercept the call for the application under test.
