Partager via


ICorProfilerInfo3, interface

Fournit des méthodes que les profileurs de code utilisent pour communiquer avec le Common Language Runtime (CLR) afin de contrôler la surveillance d'événements et de demander des informations. L'interface ICorProfilerInfo3 est une extension de l'interface ICorProfilerInfo2. Elle fournit de nouvelles méthodes prises en charge dans le .NET Framework version 4 et versions ultérieures.

Méthodes

Méthode

Description

ICorProfilerInfo3::EnumJITedFunctions, méthode

Retourne un énumérateur pour toutes les fonctions précédemment compilées juste-à-temps.

ICorProfilerInfo3::EnumModules, méthode

Retourne un énumérateur qui fournit des méthodes pour itérer de manière séquentielle au sein d'une collection de modules managés chargés dans l'application.

ICorProfilerInfo3::GetAppDomainsContainingModule, méthode

Obtient les identificateurs des domaines d'application dans lesquels le module donné a été chargé.

ICorProfilerInfo3::GetFunctionEnter3Info, méthode

Fournit le frame de pile et les informations d'argument de la fonction signalée au profileur par la fonction FunctionEnter3WithInfo ; peut être appelée uniquement pendant le rappel FunctionEnter3WithInfo.

ICorProfilerInfo3::GetFunctionLeave3Info, méthode

Fournit le frame de pile et la valeur de retour de la fonction signalée au profileur par la fonction FunctionEnter3WithInfo ; peut être appelée uniquement pendant le rappel FunctionLeave3WithInfo.

ICorProfilerInfo3::GetFunctionTailcall3Info, méthode

Fournit le frame de pile de la fonction signalée au profileur par la fonction FunctionTailcall3WithInfo ; peut être appelée uniquement pendant le rappel FunctionTailcall3WithInfo.

ICorProfilerInfo3::GetModuleInfo2, méthode

Étant donné un ID de module, retourne le nom de fichier du module, l'ID de l'assembly parent du module, et un masque de bits qui décrit les propriétés du module.

ICorProfilerInfo3::GetRuntimeInformation, méthode

Fournit des informations de version à propos du runtime profilé.

ICorProfilerInfo3::GetStringLayout2, méthode

Obtient des informations sur la disposition d'un objet chaîne.

ICorProfilerInfo3::GetThreadStaticAddress2, méthode

Obtient l'adresse du champ statique de thread spécifié qui est dans la portée du thread et du domaine d'application spécifiés.

ICorProfilerInfo3::RequestProfilerDetach, méthode

Indique au runtime de détacher le profileur.

ICorProfilerInfo3::SetEnterLeaveFunctionHooks3, méthode

Spécifie les fonctions implémentées par le profileur qui seront appelées sur les fonctions FunctionEnter3, FunctionLeave3 et FunctionTailcall3.

ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo, méthode

Spécifie les fonctions implémentées par le profileur qui seront appelées sur les raccordements FunctionEnter3WithInfo, FunctionLeave3WithInfo et FunctionTailcall3WithInfo des fonctions managées.

ICorProfilerInfo3::SetFunctionIDMapper2, méthode

Spécifie la fonction implémentée par le profileur qui sera appelée pour mapper les valeurs FunctionID aux autres valeurs, qui sont passées aux raccordements d'entrée (entry) ou de sortie (exit) de la fonction du profileur. Cette méthode étend ICorProfilerInfo::SetFunctionIDMapper avec un paramètre que les profileurs peuvent utiliser pour lever l'ambiguïté au niveau des runtimes.

Notes

Le CLR implémente les méthodes de l'interface ICorProfilerInfo3 à l'aide du modèle libre de threads. Chaque méthode retourne un HRESULT pour indiquer une réussite ou un échec. Pour obtenir la liste des codes de retour possibles, consultez le fichier CorError.h.

Le CLR passe une interface ICorProfilerInfo3 à chaque profileur de code pendant l'initialisation, à l'aide de l'implémentation du profileur de la méthode ICorProfilerCallback::Initialize ou ICorProfilerCallback3::InitializeForAttach. Un profileur de code peut ensuite appeler les méthodes ICorProfilerInfo3 pour obtenir des informations à propos du code managé en cours d'exécution sous le contrôle du CLR.

Pour plus d'informations sur les valeurs AppDomainID et FunctionID, consultez ID de profilage et de notification d'exécution.

Spécifications

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : CorProf.idl, CorProf.h

Bibliothèque : CorGuids.lib

**Versions du .NET Framework : **  4

Voir aussi

Référence

ICorProfilerInfo, interface

Autres ressources

Interfaces de profilage