Share via

ICorProfilerInfo, interface

  • Article

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’un

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

Voir aussi