ICorProfilerInfo3, interface

  • Article

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 ICorProfilerInfo3 est une extension de l’interface ICorProfilerInfo2. Elle fournit de nouvelles méthodes prises en charge dans .NET Framework 4 et versions ultérieures.

Méthodes

Méthode Description
EnumJITedFunctions, méthode Retourne un énumérateur pour toutes les fonctions précédemment compilées juste-à-temps.
EnumModules, méthode Retourne un énumérateur qui fournit des méthodes pour itérer séquentiellement au sein d’une collection de modules managés chargés dans l’application.
GetAppDomainsContainingModule, méthode Obtient les identificateurs des domaines d'application dans lesquels le module donné a été chargé.
GetFunctionEnter3Info, méthode Fournit des informations sur le frame de pile et l’argument de la fonction signalée au profileur par la fonction FunctionEnter3WithInfo ; peut être appelé uniquement pendant le rappel de FunctionEnter3WithInfo.
GetFunctionLeave3Info, méthode Fournit des informations sur le frame de pile et l’argument de la fonction signalée au profileur par la fonction FunctionEnter3WithInfo ; peut être appelé uniquement pendant le rappel de FunctionLeave3WithInfo.
GetFunctionTailcall3Info, méthode Fournit le frame de pile de la fonction signalée au profileur par la fonction FunctionTailcall3WithInfo ; peut être appelé uniquement pendant le rappel de FunctionTailcall3WithInfo.
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.
GetRuntimeInformation, méthode Fournit des informations de version sur le runtime en cours de profilage.
GetStringLayout2, méthode Obtient des informations sur la disposition d'un objet string.
GetThreadStaticAddress2, méthode Obtient l'adresse du champ statique de thread spécifié qui est dans l'étendue du thread et du domaine d'application spécifiés.
RequestProfilerDetach, méthode Indique au runtime de détacher le profileur.
SetEnterLeaveFunctionHooks3, méthode Spécifie les fonctions implémentées par le profileur à appeler sur les fonctions FunctionEnter3, FunctionLeave3 et FunctionTailcall3.
SetEnterLeaveFunctionHooks3WithInfo, méthode Spécifie les fonctions implémentées par le profileur qui seront appelées sur les crochets FunctionEnter3WithInfo, FunctionLeave3WithInfo et FunctionTailcall3WithInfo des fonctions managées.
SetFunctionIDMapper2, méthode Spécifie la fonction implémentée par le profileur qui sera appelée pour mapper des valeurs FunctionID sur d'autres valeurs, qui sont passées aux raccordements d'entrée/sortie de fonction du profileur. Cette méthode étend ICorProfilerInfo::SetFunctionIDMapper avec un paramètre que les profileurs peuvent utiliser pour lever toute ambiguïté dans les 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 la réussite ou l'é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 de la méthode ICorProfilerCallback::Initialize ou ICorProfilerCallback3::InitializeForAttach du profileur. Un profileur de code peut ensuite appeler les méthodes ICorProfilerInfo3 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 4

Voir aussi