Condividi tramite


Interfaccia ICorProfilerInfo3

Fornisce metodi che possono essere utilizzati dai Code Profiler per comunicare con Common Language Runtime (CLR) allo scopo di controllare il monitoraggio degli eventi e richiedere informazioni. L'interfaccia ICorProfilerInfo3 è un'estensione dell'interfaccia ICorProfilerInfo2. Fornisce nuovi metodi supportati in .NET Framework versione 4 e versioni successive.

Metodi

Metodo

Oggetto di descrizione

Metodo ICorProfilerInfo3::EnumJITedFunctions

Restituisce un enumeratore per tutte le funzioni compilate precedentemente tramite JIT.

Metodo ICorProfilerInfo3::EnumModules

Restituisce un enumeratore che fornisce metodi per scorrere in sequenza un insieme di moduli gestiti caricati nell'applicazione.

Metodo ICorProfilerInfo3::GetAppDomainsContainingModule

Ottiene gli identificatori dei domini di applicazione in cui è stato caricato il modulo specificato.

Metodo ICorProfilerInfo3::GetFunctionEnter3Info

Fornisce le informazioni sullo stack frame e sugli argomenti della funzione riportate al profiler dalla funzione FunctionEnter3WithInfo. Può essere chiamato solo durante il callback FunctionEnter3WithInfo.

Metodo ICorProfilerInfo3::GetFunctionLeave3Info

Fornisce lo stack frame e il valore restituito della funzione riportati al profiler dalla funzione FunctionLeave3WithInfo. Può essere chiamato solo durante il callback FunctionLeave3WithInfo.

Metodo ICorProfilerInfo3::GetFunctionTailcall3Info

Fornisce lo stack frame della funzione riportato al profiler dalla funzione FunctionTailcall3WithInfo. Può essere chiamato solo durante il callback FunctionTailcall3WithInfo.

Metodo ICorProfilerInfo3::GetModuleInfo2

Dato l'ID di un modulo, restituisce il nome file del modulo, l'ID dell'assembly padre del modulo e una maschera di bit che descrive le proprietà del modulo.

Metodo ICorProfilerInfo3::GetRuntimeInformation

Fornisce informazioni sulla versione del runtime profilato.

Metodo ICorProfilerInfo3::GetStringLayout2

Ottiene informazioni sul layout di un oggetto stringa.

Metodo ICorProfilerInfo3::GetThreadStaticAddress2

Ottiene l'indirizzo del campo statico a livello di thread specificato contenuto nell'ambito del thread e del dominio di applicazione specificati.

Metodo ICorProfilerInfo3::RequestProfilerDetach

Indica al runtime di disconnettere il profiler.

Metodo ICorProfilerInfo3::SetEnterLeaveFunctionHooks3

Specifica le funzioni implementate dal profiler che verranno chiamate sulle funzioni FunctionEnter3, FunctionLeave3 e FunctionTailcall3.

Metodo ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo

Specifica le funzioni implementate dal profiler che verranno chiamate sugli hook FunctionEnter3WithInfo, FunctionLeave3WithInfo e FunctionTailcall3WithInfo di funzioni gestite.

Metodo ICorProfilerInfo3::SetFunctionIDMapper2

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. Questo metodo estende ICorProfilerInfo::SetFunctionIDMapper con un parametro che i profiler possono utilizzare per eliminare l'ambiguità fra runtime.

Note

CLR implementa i metodi dell'interfaccia ICorProfilerInfo3 utilizzando il modello di threading Free. Ogni metodo restituisce un HRESULT per indicare l'esito positivo o negativo di un'operazione. Per un elenco dei possibili codici restituiti, vedere il file CorError.h.

CLR passa un'interfaccia ICorProfilerInfo3 a ogni Code Profiler durante l'inizializzazione, mediante l'implementazione del profiler del metodo ICorProfilerCallback::Initialize o ICorProfilerCallback3::InitializeForAttach. Un Code Profiler può quindi chiamare i metodi ICorProfilerInfo3 per ottenere informazioni sul codice gestito eseguito sotto il controllo di CLR.

Per ottenere informazioni sui valori AppDomainID e FunctionID, vedere ID notifica profilatura e runtime.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: CorProf.idl, CorProf.h

Libreria: CorGuids.lib

**Versioni di .NET Framework: **  4

Vedere anche

Riferimenti

Interfaccia ICorProfilerInfo

Altre risorse

Interfacce di profilatura