COR_PRF_EX_CLAUSE_INFO Structure

Stores information about a specific exception clause instance and its associated frame.

Syntax

typedef struct COR_PRF_EX_CLAUSE_INFO {  
    COR_PRF_CLAUSE_TYPE clauseType;  
    UINT_PTR programCounter;  
    UINT_PTR framePointer;  
    UINT_PTR shadowStackPointer;  
} COR_PRF_EX_CLAUSE_INFO;  

Members

Member	Description
clauseType	A value of the COR_PRF_CLAUSE_TYPE enumeration that specifies the type of exception clause the code just entered or left.
programCounter	The native entry point of the clause handler — for example, the contents of the X86 EIP register.
framePointer	The pointer to the logical frame for the clause handler — for example, the contents of the X86 EBP register.
shadowStackPointer	The pointer to the shadow stack. This value is the contents of the BSP register and applies only to IA64.

Remarks

When an exception notification is received, ICorProfilerInfo2::GetNotifiedExceptionClauseInfo can be used to get the native address and frame information for the exception clause (catch/finally/filter) that is about to be run or has just been run.

Execution of an exception clause involves these callbacks from the common language runtime (CLR):

• ICorProfilerCallback::ExceptionCatcherEnter

• ICorProfilerCallback::ExceptionUnwindFinallyEnter

• ICorProfilerCallback::ExceptionSearchFilterEnter

• ICorProfilerCallback::ExceptionCatcherLeave

• ICorProfilerCallback::ExceptionUnwindFinallyLeave

• ICorProfilerCallback::ExceptionSearchFilterLeave

Requirements

Platforms: See System Requirements.

Header: CorProf.idl

Library: CorGuids.lib

.NET Framework Versions: Available since 2.0

See also

• Profiling Structures