COR_PRF_EX_CLAUSE_INFO, structure

Stocke des informations sur une instance de clause d'exception spécifique et sa trame associée.

Syntaxe

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;  

Membres

Membre	Description
clauseType	Valeur de l’énumération COR_PRF_CLAUSE_TYPE qui spécifie le type de clause d’exception que le code vient d’entrer ou de quitter.
programCounter	Point d’entrée natif du gestionnaire de clauses, par exemple, le contenu du registre X86 EIP.
framePointer	Pointeur vers la trame logique pour le gestionnaire de clauses, par exemple, le contenu du registre X86 EBP.
shadowStackPointer	Pointeur vers la pile de mise en mémoire fantôme. Cette valeur correspond au contenu du registre BSP et s’applique uniquement à IA64.

Notes

Lorsqu’une notification d’exception est reçue, ICorProfilerInfo2::GetNotifiedExceptionClauseInfo peut être utilisé pour obtenir l’adresse native et les informations de frame pour la clause d’exception (catch/finally/filter) qui est sur le point d’être exécutée ou qui vient d’être exécutée.

L’exécution d’une clause d’exception implique ces rappels à partir du CLR (Common Language Runtime) :

• ICorProfilerCallback::ExceptionCatcherEnter

• ICorProfilerCallback::ExceptionUnwindFinallyEnter

• ICorProfilerCallback::ExceptionSearchFilterEnter

• ICorProfilerCallback::ExceptionCatcherLeave

• ICorProfilerCallback::ExceptionUnwindFinallyLeave

• ICorProfilerCallback::ExceptionSearchFilterLeave

Spécifications

Plateformes : Consultez Configuration requise.

Header: CorProf.idl

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible depuis la version 2.0

Voir aussi

• Structures de profilage