|
|
/***
*trnsctrl.h - routines that do special transfer of control** Copyright (c) 1993-2001, Microsoft Corporation. All rights reserved.**Purpose:* Declaration of routines that do special transfer of control.* (and a few other implementation-dependant things).** Implementations of these routines are in assembly (very implementation* dependant). Currently, these are implemented as naked functions with* inline asm.** [Internal]**Revision History:* 05-24-93 BS Module created.* 03-03-94 TL Added Mips (_M_MRX000 >= 4000) changes* 09-02-94 SKS This header file added.* 09-13-94 GJF Merged in changes from/for DEC Alpha (from Al Doser,* dated 6/21).* 10-09-94 BWT Add unknown machine merge from John Morgan* 02-14-95 CFW Clean up Mac merge.* 03-29-95 CFW Add error message to internal headers.* 04-11-95 JWM _CallSettingFrame() is now extern "C".* 12-14-95 JWM Add "#pragma once".* 02-24-97 GJF Detab-ed.* 06-01-97 TL Added P7 changes* 02-11-99 TL IA64: catch bug fix.* 05-17-99 PML Remove all Macintosh support.* 06-05-01 GB AMD64 Eh support Added.* 06-08-00 RDL VS#111429: IA64 workaround for AV while handling throw.* 07-13-01 GB ReWrite of C++Eh for AMD64 and IA64* 07-15-01 PML Remove all ALPHA, MIPS, and PPC code*****/
#if _MSC_VER > 1000 /*IFSTRIP=IGN*/
#pragma once
#endif
#ifndef _INC_TRNSCTRL
#define _INC_TRNSCTRL
#ifndef _CRTBLD
/*
* This is an internal C runtime header file. It is used when building * the C runtimes only. It is not to be used as a public header file. */#error ERROR: Use of C runtime library internal header file.
#endif /* _CRTBLD */
#if defined(_M_AMD64) /*IFSTRIP=IGN*/
typedef struct FrameInfo { PVOID pExceptionObject; struct FrameInfo * pNext;} FRAMEINFO;
extern void _UnlinkFrame(FRAMEINFO *pFrameInfo);extern FRAMEINFO* _FindFrameInfo(PVOID, FRAMEINFO*);extern VOID _JumpToContinuation(unsigned __int64, CONTEXT*, EHExceptionRecord*);extern BOOL _ExecutionInCatch(DispatcherContext*, FuncInfo*);extern VOID __FrameUnwindToEmptyState(EHRegistrationNode*, DispatcherContext*, FuncInfo*);extern VOID _FindAndUnlinkFrame(FRAMEINFO *);extern FRAMEINFO* _CreateFrameInfo(FRAMEINFO*, PVOID);extern int _IsExceptionObjectToBeDestroyed(PVOID);extern "C" VOID _UnwindNestedFrames( EHRegistrationNode*, EHExceptionRecord*, CONTEXT* , EHRegistrationNode*, void*, __ehstate_t, FuncInfo *, DispatcherContext*, BOOLEAN );extern "C" PVOID __CxxCallCatchBlock(EXCEPTION_RECORD*);extern "C" PVOID _CallSettingFrame( void*, EHRegistrationNode*, ULONG );extern "C" BOOL _CallSETranslator( EHExceptionRecord*, EHRegistrationNode*, CONTEXT*, DispatcherContext*, FuncInfo*, ULONG, EHRegistrationNode*);extern "C" VOID _EHRestoreContext(CONTEXT* pContext);extern "C" unsigned __int64 _GetImageBase(VOID);extern "C" unsigned __int64 _GetThrowImageBase(VOID);extern "C" VOID _SetThrowImageBase(unsigned __int64 NewThrowImageBase);extern TryBlockMapEntry *_GetRangeOfTrysToCheck(EHRegistrationNode *, FuncInfo *, int, __ehstate_t, unsigned *, unsigned *, DispatcherContext* );extern EHRegistrationNode *_GetEstablisherFrame(EHRegistrationNode*, DispatcherContext*, FuncInfo*, EHRegistrationNode* );
#define _CallMemberFunction0(pthis, pmfn) (*(VOID(*)(PVOID))pmfn)(pthis)
#define _CallMemberFunction1(pthis, pmfn, pthat) (*(VOID(*)(PVOID,PVOID))pmfn)(pthis,pthat)
#define _CallMemberFunction2(pthis, pmfn, pthat, val2 ) (*(VOID(*)(PVOID,PVOID,int))pmfn)(pthis,pthat,val2)
#define OffsetToAddress( off, FP ) (void*)(((char*)FP) + off)
#define UNWINDSTATE(base,offset) *((int*)((char*)base + offset))
#define UNWINDTRYBLOCK(base,offset) *((int*)( (char*)(OffsetToAddress(offset,base)) + 4 ))
#define UNWINDHELP(base,offset) *((__int64*)((char*)base + offset))
#elif defined(_M_IA64) /*IFSTRIP=IGN*/
typedef struct FrameInfo { PVOID pExceptionObject; struct FrameInfo * pNext;} FRAMEINFO;
extern void _UnlinkFrame(FRAMEINFO *pFrameInfo);extern FRAMEINFO* _FindFrameInfo(PVOID, FRAMEINFO*);extern VOID _JumpToContinuation(unsigned __int64, CONTEXT*, EHExceptionRecord*);extern BOOL _ExecutionInCatch(DispatcherContext*, FuncInfo*);extern VOID __FrameUnwindToEmptyState(EHRegistrationNode*, DispatcherContext*, FuncInfo*);extern VOID _FindAndUnlinkFrame(FRAMEINFO *);extern FRAMEINFO* _CreateFrameInfo(FRAMEINFO*, PVOID);extern int _IsExceptionObjectToBeDestroyed(PVOID);extern "C" VOID _UnwindNestedFrames( EHRegistrationNode*, EHExceptionRecord*, CONTEXT* , EHRegistrationNode*, void*, __ehstate_t, FuncInfo *, DispatcherContext*, BOOLEAN );extern "C" PVOID __CxxCallCatchBlock(EXCEPTION_RECORD*);extern "C" PVOID _CallSettingFrame( void*, EHRegistrationNode*, ULONG );extern "C" BOOL _CallSETranslator( EHExceptionRecord*, EHRegistrationNode*, CONTEXT*, DispatcherContext*, FuncInfo*, ULONG, EHRegistrationNode*);extern "C" VOID _EHRestoreContext(CONTEXT* pContext);extern "C" unsigned __int64 _GetImageBase(VOID);extern "C" unsigned __int64 _GetThrowImageBase(VOID);extern "C" VOID _SetImageBase(unsigned __int64 ImageBaseToRestore);extern "C" VOID _SetThrowImageBase(unsigned __int64 NewThrowImageBase);extern "C" VOID _MoveContext(CONTEXT* pTarget, CONTEXT* pSource);extern TryBlockMapEntry *_GetRangeOfTrysToCheck(EHRegistrationNode *, FuncInfo *, int, __ehstate_t, unsigned *, unsigned *, DispatcherContext*);extern EHRegistrationNode *_GetEstablisherFrame(EHRegistrationNode*, DispatcherContext*, FuncInfo*, EHRegistrationNode*);
#define _CallMemberFunction0(pthis, pmfn) (*(VOID(*)(PVOID))pmfn)(pthis)
#define _CallMemberFunction1(pthis, pmfn, pthat) (*(VOID(*)(PVOID,PVOID))pmfn)(pthis,pthat)
#define _CallMemberFunction2(pthis, pmfn, pthat, val2 ) (*(VOID(*)(PVOID,PVOID,int))pmfn)(pthis,pthat,val2)
#define OffsetToAddress( off, FP ) (void*)(((char*)FP) + off)
#define UNWINDSTATE(base,offset) *((int*)((char*)base + offset))
#define UNWINDTRYBLOCK(base,offset) *((int*)( (char*)(OffsetToAddress(offset,base)) + 4 ))
#define UNWINDHELP(base,offset) *((__int64*)((char*)base + offset))
#elif defined(_M_IX86) // x86
//
// For calling funclets (including the catch)
//
extern "C" void * __stdcall _CallSettingFrame( void *, EHRegistrationNode *, unsigned long );extern void __stdcall _JumpToContinuation( void *, EHRegistrationNode * );
//
// For calling member functions:
//
extern void __stdcall _CallMemberFunction0( void *pthis, void *pmfn );extern void __stdcall _CallMemberFunction1( void *pthis, void *pmfn, void *pthat );extern void __stdcall _CallMemberFunction2( void *pthis, void *pmfn, void *pthat, int val2 );
//
// Translate an ebp-relative offset to a hard address based on address of
// registration node:
//
#if !CC_EXPLICITFRAME
#define OffsetToAddress( off, RN ) \
(void*)((char*)RN \ + FRAME_OFFSET \ + off)#else
#define OffsetToAddress( off, RN ) (void*)(((char*)RN->frame) + off)
#endif
//
// Call RtlUnwind in a returning fassion
//
extern void __stdcall _UnwindNestedFrames( EHRegistrationNode*, EHExceptionRecord* );
//
// Do the nitty-gritty of calling the catch block safely
//
void *_CallCatchBlock2( EHRegistrationNode *, FuncInfo*, void*, int, unsigned long );
//
// Link together all existing catch objects to determine when they should be destroyed
//
typedef struct FrameInfo { PVOID pExceptionObject; struct FrameInfo * pNext;} FRAMEINFO;
extern FRAMEINFO * _CreateFrameInfo(FRAMEINFO*, PVOID);extern BOOL IsExceptionObjectToBeDestroyed(PVOID);extern void _FindAndUnlinkFrame(FRAMEINFO*);
//
// Ditto the SE translator
//
BOOL _CallSETranslator( EHExceptionRecord*, EHRegistrationNode*, void*, DispatcherContext*, FuncInfo*, int, EHRegistrationNode*);
extern TryBlockMapEntry *_GetRangeOfTrysToCheck(FuncInfo *, int, __ehstate_t, unsigned *, unsigned *);#else
#pragma message("Special transfer of control routines not defined for this platform")
#endif
#endif /* _INC_TRNSCTRL */
|
