ICorProfilerInfo3, 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 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
