ICorProfilerInfo, interface
Fournit des méthodes utilisées par les profileurs de code pour communiquer avec le Common Language Runtime (CLR) pour contrôler le monitoring des événements et demander des informations.
Notes
Chaque méthode de l’interface ICorProfilerInfo 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.
Méthodes
| méthode | Description |
|---|---|
| BeginInprocDebugging, méthode | Initialise la prise en charge du débogage in-process. Cette méthode est obsolète dans le .NET Framework version 2.0. |
| EndInprocDebugging, méthode | Arrête une session de débogage in-process. Cette méthode est obsolète dans le .NET Framework version 2.0. |
| ForceGC, méthode | Force le garbage collection pendant le runtime. |
| GetAppDomainInfo, méthode | Obtient des informations sur le domaine d’application spécifié. |
| GetAssemblyInfo, méthode | Obtient des informations sur l’assembly spécifié. |
| GetClassFromObject, méthode | Obtient le ClassID d’unobjet, en se basant sur son ObjectID. |
| GetClassFromToken, méthode | Obtient l’ID de la classe, en se basant sur le jeton de métadonnées. Cette méthode est obsolète dans le .NET Framework version 2.0. Utilisez plutôt la méthode ICorProfilerInfo2::GetClassFromTokenAndTypeArgs. |
| GetClassIDInfo, méthode | Obtient le module parent et le jeton de métadonnées de la classe spécifiée. |
| GetCodeInfo, méthode | Obtient l'étendue de code natif associée à l'ID de la fonction spécifiée. Cette méthode est obsolète. Utilisez la méthode ICorProfilerInfo2::GetCodeInfo2 à la place. |
| GetCurrentThreadID, méthode | Obtient l’ID du thread actuel, s’il s’agit d’un thread managé. |
| GetEventMask, méthode | Obtient les catégories des événements actuels pour lesquels le profileur souhaite recevoir des notifications de la part du CLR. |
| GetFunctionFromIP, méthode | Mappe un pointeur d’instructions de code managé à un FunctionID. |
| GetFunctionFromToken, méthode | Obtient l’ID d’une fonction. Cette méthode est obsolète dans le .NET Framework version 2.0. Utilise la méthode ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs à la place. |
| GetFunctionInfo, méthode | Obtient la classe parente et le jeton de métadonnées pour la fonction spécifiée. |
| GetHandleFromThread, méthode | Mappe l’ID d’un thread à un descripteur de thread Win32. |
| GetILFunctionBody, méthode | Obtient un pointeur vers le corps d’une méthode dans le code CIL (Common Intermediate Language), en commençant à son en-tête. |
| GetILFunctionBodyAllocator, méthode | Obtient une interface qui fournit une méthode permettant d’allouer de la mémoire à utiliser pour échanger le corps d’une méthode dans le code CIL. |
| GetILToNativeMapping, méthode | Obtient une carte des décalages CIL vers des décalages natifs pour le code contenu dans la fonction spécifiée. |
| GetInprocInspectionInterface, méthode | Obtient un objet pouvant être interrogé pour une interface ICorDebugProcess. Cette méthode est obsolète dans le .NET Framework version 2.0. |
| GetInprocInspectionIThisThread, méthode | Obtient un objet pouvant être interrogé pour l’interface ICorDebugThread. Cette méthode est obsolète dans le .NET Framework version 2.0. |
| GetModuleInfo, méthode | Pour un ID de module donné, retourne le nom de fichier du module et l'ID de l'assembly parent du module. |
| GetModuleMetaData, méthode | Obtient une instance d’interface de métadonnées qui correspond au module spécifié. |
| GetObjectSize, méthode | Obtient la taille d’un objet spécifié. |
| GetThreadContext, méthode | Obtient l’identité du contexte actuellement associée au thread spécifié. |
| GetThreadInfo, méthode | Obtient l’identité du thread Win32 actuel pour le thread spécifié. |
| GetTokenAndMetadataFromFunction, méthode | Obtient le jeton de métadonnées et une instance de l’interface de métadonnées qui peut être comparée au jeton de la fonction spécifiée. |
| IsArrayClass, méthode | Détermine si la classe spécifiée est une classe de tableau. |
| SetEnterLeaveFunctionHooks, méthode | Spécifie les fonctions implémentées par profileur à appeler sur les raccordements « enter », « leave » et « tailcall » des fonctions managées. |
| SetEventMask, méthode | Définit une valeur qui spécifie les types d’événements pour lesquels le profileur veut recevoir des notifications du CLR. |
| SetFunctionIDMapper, 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. |
| SetFunctionReJIT, méthode | Non implémenté. Ne pas utiliser. |
| SetILFunctionBody, méthode | Remplace le corps de la fonction spécifiée dans le module spécifié. |
| SetILInstrumentedCodeMap, méthode | Spécifie comment les décalages d’un mappage CIL d’origine d’une fonction spécifiée vers les nouveaux décalages du CIL modifié par le profileur de la fonction. |
Notes
Un profileur appelle une méthode dans l’interface ICorProfilerInfo pour communiquer avec le CLR afin de contrôler l’analyse des événements et 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 la réussite ou l'échec. Pour obtenir la liste des codes de retour possibles, consultez le fichier CorError.h.
À l’aide de l’implémentation du ICorProfilerCallback::InitializeICorProfilerInfo du profileur, le CLR passe une interface à chaque profileur de code lors de l’initialisation. Un profileur de code peut ensuite appeler les méthodes de l’interface ICorProfilerInfo 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
