ICorProfilerInfo2, interface
Fournit des méthodes utilisées par les profileurs de code pour communiquer avec le Common Language Runtime (CLR) pour contrôler la surveillance des événements et demander des informations. L’interface ICorProfilerInfo2 est une extension de l’interface ICorProfilerInfo. Autrement dit, elle fournit de nouvelles méthodes prises en charge dans le .NET Framework version 2.0 et ultérieure.
Méthodes
| Méthode | Description |
|---|---|
| DoStackSnapshot, méthode | Parcourt la pile du thread spécifié pour signaler les frames d’appel managés au profileur. |
| EnumModuleFrozenObjects, méthode | Obtient un énumérateur qui autorise l’itération sur les objets figés dans le module spécifié. |
| GetAppDomainStaticAddress, méthode | Obtient l’adresse du champ statique par domaine d’application spécifié qui est dans l’étendue du domaine d’application spécifié. |
| GetArrayObjectInfo, méthode | Obtient des informations détaillées sur un objet tableau. |
| GetBoxClassLayout, méthode | Obtient des informations sur la disposition de classe pour un type de valeur spécifié qui est boxed. |
| GetClassFromTokenAndTypeArgs, méthode | Obtient le ClassID d’un type à l’aide du jeton de métadonnées spécifié et des valeurs ClassID des arguments de type. |
| GetClassIDInfo2, méthode | Obtient le module parent de la classe générique spécifiée, le jeton de métadonnées de la classe, le ClassID de sa classe parente et le ClassID pour chaque argument de type, le cas échéant, de la classe. |
| GetClassLayout, méthode | Obtient des informations sur la disposition, dans la mémoire, des champs définis par la classe spécifiée. Autrement dit, cette méthode obtient les offsets des champs de la classe. |
| GetCodeInfo2, méthode | Obtient l'étendue de code natif associée au FunctionID spécifié. |
| GetContextStaticAddress, méthode | Obtient l’adresse du champ statique par contexte spécifié qui se trouve dans l’étendue du contexte spécifié. |
| GetFunctionFromTokenAndTypeArgs, méthode | Obtient le FunctionID d’une fonction à l’aide du jeton de métadonnées spécifié, la classe conteneur et les valeurs ClassID des arguments de type. |
| GetFunctionInfo2, méthode | Obtient la classe parente, le jeton de métadonnées et le ClassID de chaque argument de type, le cas échéant, d’une fonction. |
| GetGenerationBounds, méthode | Obtient les régions de la mémoire (segments du tas) qui composent les générations du tas récupéré par le garbage collector. |
| GetNotifiedExceptionClauseInfo, méthode | Obtient les informations d’adresse et de frame natives 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. |
| GetObjectGeneration, méthode | Obtient le segment du tas qui contient l’objet spécifié. |
| GetRVAStaticAddress, méthode | Obtient l’adresse du champ statique par adresse virtuelle relative spécifié. |
| GetStaticFieldInfo, méthode | Obtient l’étendue dans laquelle le champ spécifié est statique. |
| GetStringLayout, méthode | Obtient des informations sur la disposition d'un objet string. |
| GetThreadAppDomain, méthode | Obtient l’ID du domaine d’application dans lequel le thread spécifié exécute actuellement du code. |
| GetThreadStaticAddress, méthode | Obtient l’adresse du champ statique par thread spécifié qui est dans l’étendue du thread spécifié. |
| SetEnterLeaveFunctionHooks2, méthode | Spécifie les fonctions implémentées par profileur à appeler sur les raccordements « enter », « leave » et « tailcall » des fonctions managées. |
Notes
Un profileur appelle une méthode dans l’interface ICorProfilerInfo2 pour communiquer avec le CLR afin de contrôler l’analyse des événements et demander des informations.
Les méthodes de l’interface ICorProfilerInfo2 sont implémentées par le CLR à l’aide du modèle libre de threads. Chaque méthode retourne un HRESULT pour indiquer la réussite ou l'échec. Pour obtenir la liste des codes de retour possibles, consultez le fichier CorError.h.
Le CLR transmet une interface ICorProfilerInfo2 à chaque profileur de code lors de l’initialisation, à l’aide de l’implémentation de ICorProfilerCallback::Initialize du profileur. Un profileur de code peut ensuite appeler les méthodes de l’interface ICorProfilerInfo2 pour obtenir des informations sur le code managé qui est en cours d’exécution sous le contrôle du CLR.
Spécifications
Plateformes : Consultez Configuration requise.
En-tête : CorProf.idl, CorProf.h
Bibliothèque : CorGuids.lib
Versions de .NET Framework : Disponible depuis la version 2.0
