Interfaccia ICorProfilerInfo

Fornisce metodi che possono essere utilizzati dai Code Profiler per comunicare con Common Language Runtime allo scopo di controllare il monitoraggio degli eventi e richiedere informazioni.

Nota
Ogni metodo nell'interfaccia ICorProfilerInfo restituisce un HRESULT per indicare la riuscita o la mancata esecuzione di un'operazione.Per un elenco di valori restituiti possibili, vedere CorError.h.

Metodi

Metodo	Oggetto di descrizione
Metodo ICorProfilerInfo::BeginInprocDebugging	Inizializza il supporto del debug in-process. Questo metodo è obsoleto in .NET Framework versione 2.0.
Metodo ICorProfilerInfo::EndInprocDebugging	Arresta una sessione di debug in-process. Questo metodo è obsoleto in .NET Framework versione 2.0.
Metodo ICorProfilerInfo::ForceGC	Impone l'esecuzione della Garbage Collection all'interno di Common Language Runtime.
Metodo ICorProfilerInfo::GetAppDomainInfo	Ottiene le informazioni relative al dominio applicazione specificato.
Metodo ICorProfilerInfo::GetAssemblyInfo	Ottiene informazioni sull'assembly specificato.
Metodo ICorProfilerInfo::GetClassFromObject	Ottiene il valore ClassID di un oggetto, dato il relativo valore ObjectID.
Metodo ICorProfilerInfo::GetClassFromToken	Ottiene l'ID della classe, dato il token di metadati. Questo metodo è obsoleto in .NET Framework versione 2.0. Utilizzare invece il metodo ICorProfilerInfo2::GetClassFromTokenAndTypeArgs.
Metodo ICorProfilerInfo::GetClassIDInfo	Ottiene il modulo padre e il token di metadati per la classe specificata.
Metodo ICorProfilerInfo::GetCodeInfo	Ottiene l'ambito del codice nativo associato all'identificatore funzione specificato. Questo metodo è obsoleto. Utilizzare invece il metodo ICorProfilerInfo2::GetCodeInfo2.
Metodo ICorProfilerInfo::GetCurrentThreadID	Ottiene l'ID del thread corrente, se si tratta di un thread gestito.
Metodo ICorProfilerInfo::GetEventMask	Ottiene le categorie di evento correnti per le quali il profiler desidera ricevere notifiche degli eventi da Common Language Runtime.
Metodo ICorProfilerInfo::GetFunctionFromIP	Esegue il mapping di un puntatore all'istruzione di codice gestito alla funzione specificata dal parametro FunctionID.
Metodo ICorProfilerInfo::GetFunctionFromToken	Ottiene l'ID di una funzione. Questo metodo è obsoleto in .NET Framework versione 2.0. Utilizzare invece il metodo ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs.
Metodo ICorProfilerInfo::GetFunctionInfo	Ottiene la classe padre e il token di metadati per la funzione specificata.
Metodo ICorProfilerInfo::GetHandleFromThread	Esegue il mapping dell'ID di un thread a un handle di thread Win32.
Metodo ICorProfilerInfo::GetILFunctionBody	Ottiene un puntatore al corpo di un metodo nel codice MSIL (Microsoft Intermediate Language), a partire dalla relativa intestazione.
Metodo ICorProfilerInfo::GetILFunctionBodyAllocator	Ottiene un'interfaccia che fornisce un metodo per allocare la memoria da utilizzare per eseguire lo swapping del corpo di un metodo nel codice MSIL.
Metodo ICorProfilerInfo::GetILToNativeMapping	Ottiene una mappa dagli offset MSIL agli offset nativi per il codice contenuto nella funzione specificata.
Metodo ICorProfilerInfo::GetInprocInspectionInterface	Ottiene un oggetto sul quale è possibile eseguire una query per un'interfaccia ICorDebugProcess. Questo metodo è obsoleto in .NET Framework versione 2.0.
Metodo ICorProfilerInfo::GetInprocInspectionIThisThread	Ottiene un oggetto sul quale è possibile eseguire una query relativa all'interfaccia ICorDebugThread. Questo metodo è obsoleto in .NET Framework versione 2.0.
Metodo ICorProfilerInfo::GetModuleInfo	Dato l'ID di un modulo, restituisce il nome file del modulo e l'ID dell'assembly padre del modulo.
Metodo ICorProfilerInfo::GetModuleMetaData	Ottiene un'istanza di interfaccia di metadati che viene mappata al modulo specificato.
Metodo ICorProfilerInfo::GetObjectSize	Ottiene la dimensione di un oggetto specificato.
Metodo ICorProfilerInfo::GetThreadContext	Ottiene l'identità del contesto attualmente associata al thread specificato.
Metodo ICorProfilerInfo::GetThreadInfo	Ottiene l'identità thread Win32 corrente per il thread specificato.
Metodo ICorProfilerInfo::GetTokenAndMetadataFromFunction	Ottiene il token di metadati e un'istanza dell'interfaccia di metadati che può essere utilizzata sulla base del token per la funzione specificata.
Metodo ICorProfilerInfo::IsArrayClass	Determina se la classe specificata è una classe di matrice.
Metodo ICorProfilerInfo::SetEnterLeaveFunctionHooks	Specifica le funzioni implementate tramite profiler da chiamare sugli hook "enter", "leave" e "tailcall" delle funzioni gestite.
Metodo ICorProfilerInfo::SetEventMask	Imposta un valore che specifica i tipi di eventi per i quali il profiler desidera ricevere notifica da Common Language Runtime.
Metodo ICorProfilerInfo::SetFunctionIDMapper	Specifica la funzione implementata dal profiler che verrà chiamata per eseguire il mapping dei valori FunctionID ai valori alternativi, passati agli hook di ingresso/uscita della funzione del profiler.
Metodo ICorProfilerInfo::SetFunctionReJIT	Non implementato. Non utilizzare.
Metodo ICorProfilerInfo::SetILFunctionBody	Sostituisce il corpo della funzione specificata nel modulo specificato.
Metodo ICorProfilerInfo::SetILInstrumentedCodeMap	Specifica la modalità di mapping degli offset del codice MSIL originale di una funzione specificata ai nuovi offset del codice MSIL modificato tramite profiler della funzione.

Note

Un profiler chiama un metodo nell'interfaccia ICorProfilerInfo per comunicare con Common Language Runtime allo scopo di controllare il monitoraggio degli eventi e richiedere informazioni.

I metodi dell'interfaccia ICorProfilerInfo vengono implementati da Common Language Runtime utilizzando il modello di thread libero. Ogni metodo restituisce un HRESULT per indicare l'esito positivo o negativo di un'operazione. Per un elenco di valori restituiti possibili, vedere CorError.h.

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

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: CorProf.idl, CorProf.h

Libreria: CorGuids.lib

Versioni di .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vedere anche

Riferimenti

Interfaccia ICorProfilerInfo2

Altre risorse

Interfacce di profilatura