COR_PRF_EX_CLAUSE_INFO Structure

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

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 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 Method 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):

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: CorProf.idl

Library: CorGuids.lib

.NET Framework Version: 2.0

See Also

Other Resources

Profiling Structures