ICorProfilerInfo, interface
Fournit des méthodes que les profileurs de code utilisent pour communiquer avec le Common Language Runtime (CLR) pour contrôler la surveillance d'événements et demander des informations.
.gif "Remarque") Remarque |
|---|
Chaque méthode de l'interface ICorProfilerInfo retourne un HRESULT pour indiquer une réussite ou un échec.Consultez le fichier CorError.h pour obtenir la liste des codes de retour possibles. |
Méthodes
Méthode |
Description |
|---|---|
Initialise la prise en charge du débogage en cours de processus. Cette méthode est obsolète dans la version 2.0 du .NET Framework. |
|
Arrête une session de débogage en cours de processus. Cette méthode est obsolète dans la version 2.0 du .NET Framework. |
|
Force le garbage collection dans le runtime. |
|
Obtient des informations sur le domaine d'application spécifié. |
|
Obtient des informations à propos de l'assembly spécifié. |
|
Obtient le ClassID d'un objet, compte tenu de son ObjectID. |
|
Obtient l'ID de la classe, d'après le jeton de métadonnées. Cette méthode est obsolète dans la version 2.0 du .NET Framework. Utilisez à la place la méthode ICorProfilerInfo2::GetClassFromTokenAndTypeArgs. |
|
Obtient le module parent et le jeton de métadonnées pour la classe spécifiée. |
|
Obtient l'étendue de code natif associées à l'ID de fonction spécifié. Cette méthode est obsolète. Utilisez à la place la méthode ICorProfilerInfo2::GetCodeInfo2. |
|
Obtient l'ID du thread actuel, s'il s'agit d'un thread managé. |
|
Obtient les catégories d'événement actuelles pour lesquelles le profileur souhaite recevoir des notifications d'événement du CLR. |
|
Mappe un pointeur d'instructions de code managé à un FunctionID. |
|
Obtient l'ID d'une fonction. Cette méthode est obsolète dans la version 2.0 du .NET Framework. Utilisez à la place la méthode ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs. |
|
Obtient la classe parente et le jeton de métadonnées pour la fonction spécifiée. |
|
Mappe l'ID d'un thread à un handle de thread Win32. |
|
Obtient un pointeur vers le corps d'une méthode dans le code MSIL (Microsoft Intermediate Language), à partir de son en-tête. |
|
Obtient une interface qui fournit une méthode pour allouer de la mémoire en vue de permuter le corps d'une méthode en code MSIL. |
|
Obtient un mappage entre les offsets MSIL et les offsets natifs pour le code contenu dans la fonction spécifiée. |
|
Obtient un objet qui peut être interrogé pour une interface ICorDebugProcess. Cette méthode est obsolète dans la version 2.0 du .NET Framework. |
|
Obtient un objet qui peut être interrogé pour l'interface ICorDebugThread. Cette méthode est obsolète dans la version 2.0 du .NET Framework. |
|
Étant donné un ID de module, retourne le nom de fichier du module et l'ID de l'assembly parent du module. |
|
Obtient une instance d'interface de métadonnées qui mappe au module spécifié. |
|
Obtient la taille d'un objet spécifié. |
|
Obtient l'identité de contexte actuellement associée au thread spécifié. |
|
Obtient l'identité de thread Win32 actuelle pour le thread spécifié. |
|
Obtient le jeton de métadonnées et une instance de l'interface de métadonnées pouvant être utilisés avec le jeton pour la fonction spécifiée. |
|
Détermine si la classe spécifiée est une classe de tableau. |
|
Spécifie les fonctions implémentées par le générateur de profils à appeler sur des raccordements « enter », « leave » et « tailcall » de fonctions managées. |
|
Définit une valeur qui spécifie les types d'événements pour lesquels le profileur souhaite recevoir une notification du CLR. |
|
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. |
|
Non implémenté. Ne pas utiliser. |
|
Remplace le corps de la fonction spécifiée dans le module spécifié. |
|
Spécifie le mappage des offsets du code MSIL d'origine d'une fonction spécifiée aux nouveaux offsets du code MSIL modifié par le profileur d'une fonction. |
Notes
Un profileur appelle une méthode dans l'interface ICorProfilerInfo pour communiquer avec le CLR afin de contrôler la surveillance d'événements et de demander des informations.
Les méthodes de l'interface ICorProfilerInfo sont implémentées par le CLR à l'aide du modèle libre de threads. Chaque méthode retourne un HRESULT pour indiquer une réussite ou un échec. Consultez le fichier CorError.h pour obtenir la liste des codes de retour possibles.
Le CLR passe, via l'implémentation d'ICorProfilerCallback::Initialize du profileur, une interface ICorProfilerInfo à chaque profileur de code lors de l'initialisation. Un profileur de code peut ensuite appeler des méthodes de l'interface ICorProfilerInfo pour obtenir des informations à propos du code managé en cours d'exécution sous le contrôle du Common Language Runtime.
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, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0