Interfaccia ICorProfilerInfo

  • Articolo

Fornisce metodi per l'uso da parte dei profiler di codice per comunicare con Common Language Runtime (CLR) per controllare il monitoraggio degli eventi e richiedere informazioni.

Nota

Ogni metodo nell'interfaccia restituisce un HRESULT per indicare l'esito ICorProfilerInfo positivo o negativo. Per un elenco dei possibili codici restituiti, vedere CorError.h.

Metodi

metodo Descrizione
Metodo BeginInprocDebugging Inizializza il supporto del debug in-process. Questo metodo è obsoleto in .NET Framework versione 2.0.
Metodo EndInprocDebugging Arresta una sessione di debug in-process. Questo metodo è obsoleto in .NET Framework versione 2.0.
Metodo ForceGC Forza l'esecuzione di Garbage Collection all'interno del runtime.
Metodo GetAppDomainInfo Ottiene informazioni sul dominio applicazione specificato.
Metodo GetAssemblyInfo Ottiene informazioni sull'assembly specificato.
Metodo GetClassFromObject Ottiene l'oggetto ClassID di un oggetto

oggetto, dato il relativo ObjectIDoggetto .
Metodo GetClassFromToken Ottiene l'ID della classe, dato il token di metadati. Questo metodo è obsoleto in .NET Framework versione 2.0. Usare invece il metodo ICorProfilerInfo2::GetClassFromTokenAndTypeArgs .
Metodo GetClassIDInfo Ottiene il modulo padre e il token di metadati per la classe specificata.
Metodo GetCodeInfo Ottiene l'ambito del codice nativo associato all'ID funzione specificato. Questo metodo è obsoleto. Usare invece il metodo ICorProfilerInfo2::GetCodeInfo2 .
Metodo GetCurrentThreadID Ottiene l'ID del thread corrente, se è un thread gestito.
Metodo GetEventMask Ottiene le categorie di eventi correnti per cui il profiler desidera ricevere notifiche degli eventi da CLR.
Metodo GetFunctionFromIP Mappe un puntatore all'istruzione del codice gestito a un oggetto FunctionID.
Metodo GetFunctionFromToken Ottiene l'ID di una funzione. Questo metodo è obsoleto in .NET Framework versione 2.0. Usare invece il metodo ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs .
Metodo GetFunctionInfo Ottiene la classe padre e il token di metadati per la funzione specificata.
Metodo GetHandleFromThread Mappe l'ID di un thread a un handle di thread Win32.
Metodo GetILFunctionBody Ottiene un puntatore al corpo di un metodo nel codice CIL (Common Intermediate Language), a partire dalla relativa intestazione.
Metodo GetILFunctionBodyAllocator Ottiene un'interfaccia che fornisce un metodo per allocare memoria da utilizzare per lo scambio del corpo di un metodo nel codice CIL.
Metodo GetILToNativeMapping Ottiene una mappa dagli offset CIL agli offset nativi per il codice contenuto nella funzione specificata.
Metodo GetInprocInspectionInterface Ottiene un oggetto su cui è possibile eseguire una query per un'interfaccia ICorDebugProcess. Questo metodo è obsoleto in .NET Framework versione 2.0.
Metodo GetInprocInspectionIThisThread Ottiene un oggetto su cui è possibile eseguire una query per l'interfaccia ICorDebugThread. Questo metodo è obsoleto in .NET Framework versione 2.0.
Metodo GetModuleInfo Dato un ID modulo, restituisce il nome file del modulo e l'ID dell'assembly padre del modulo.
Metodo GetModuleMetaData Ottiene un'istanza dell'interfaccia dei metadati mappata al modulo specificato.
Metodo GetObjectSize Ottiene le dimensioni di un oggetto specificato.
Metodo GetThreadContext Ottiene l'identità del contesto attualmente associata al thread specificato.
Metodo GetThreadInfo Ottiene l'identità del thread Win32 corrente per il thread specificato.
Metodo GetTokenAndMetadataFromFunction Ottiene il token di metadati e un'istanza dell'interfaccia dei metadati che può essere usata sul token per la funzione specificata.
Metodo IsArrayClass Determina se la classe specificata è una classe di matrice.
Metodo SetEnterLeaveFunctionHooks Specifica le funzioni implementate dal profiler da chiamare in "enter", "leave" e "tailcall" di funzioni gestite.
Metodo SetEventMask Imposta un valore che specifica i tipi di eventi per cui il profiler desidera ricevere la notifica da CLR.
Metodo SetFunctionIDMapper Specifica la funzione implementata dal profiler che verrà chiamata per trasformare i valori FunctionID in valori alternativi, che vengono passati agli hook di ingresso/uscita delle funzioni del profiler.
Metodo SetFunctionReJIT Non implementata. Non utilizzare.
Metodo SetILFunctionBody Sostituisce il corpo della funzione specificata nel modulo specificato.
Metodo SetILInstrumentedCodeMap Specifica il modo in cui gli offset dell'CIL originale di una funzione specificata vengono mappati ai nuovi offset dell'CIL modificato dal profiler della funzione.

Osservazioni:

Un profiler chiama un metodo nell'interfaccia ICorProfilerInfo per comunicare con CLR per controllare il monitoraggio degli eventi e richiedere informazioni.

I metodi dell'interfaccia ICorProfilerInfo vengono implementati da CLR usando il modello a thread libero. Ogni metodo restituisce un valore HRESULT per indicare esito positivo o negativo. Per un elenco dei possibili codici restituiti, vedere CorError.h.

CLR passa, tramite l'implementazione del profiler di ICorProfilerCallback::Initialize, un'interfaccia ICorProfilerInfo a ogni profiler di codice durante l'inizializzazione. Un profiler di codice può quindi chiamare metodi dell'interfaccia ICorProfilerInfo per ottenere informazioni sul codice gestito eseguito sotto il controllo di CLR.

Requisiti

Piattaforme: vedere Requisiti di sistema.

Intestazione: CorProf.idl, CorProf.h

Libreria: CorGuids.lib

Versioni di .NET Framework: disponibili dalla versione 2.0

Vedi anche