Interfaccia ICorProfilerInfo3

  • Articolo

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

Metodi

Metodo Descrizione
Metodo EnumJITedFunctions Restituisce un enumeratore per tutte le funzioni sottoposte in precedenza a compilazione JIT.
Metodo EnumModules Restituisce un enumeratore che fornisce i metodi per scorrere in sequenza una raccolta di moduli gestiti caricati nell'applicazione.
Metodo GetAppDomainsContainingModule Ottiene gli identificatori dei domini dell'applicazione in cui è stato caricato il modulo specificato.
Metodo GetFunctionEnter3Info Fornisce informazioni sullo stack frame e sull'argomento della funzione segnalata al profiler dalla funzione FunctionEnter3WithInfo ; può essere chiamato solo durante il FunctionEnter3WithInfo callback.
Metodo GetFunctionLeave3Info Fornisce lo stack frame e il valore restituito della funzione segnalata al profiler dalla funzione FunctionLeave3WithInfo ; può essere chiamato solo durante il FunctionLeave3WithInfo callback.
Metodo GetFunctionTailcall3Info Fornisce lo stack frame della funzione segnalata al profiler dalla funzione FunctionTailcall3WithInfo ; può essere chiamato solo durante il FunctionTailcall3WithInfo callback.
Metodo GetModuleInfo2 Dato un ID 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 GetRuntimeInformation Fornisce informazioni sulla versione relative al runtime che viene profilato.
Metodo GetStringLayout2 Ottiene informazioni sul layout di un oggetto stringa.
Metodo GetThreadStaticAddress2 Ottiene l'indirizzo del campo statico a livello di thread specificato che è nell'ambito del dominio dell'applicazione e del thread specificati.
Metodo RequestProfilerDetach Indica al runtime di disconnettere il profiler.
Metodo SetEnterLeaveFunctionHooks3 Specifica le funzioni implementate dal profiler che verranno chiamate nelle funzioni FunctionEnter3, FunctionLeave3 e FunctionTailcall3 .
Metodo SetEnterLeaveFunctionHooks3WithInfo Specifica le funzioni implementate dal profiler che verranno chiamate negli hook FunctionEnter3WithInfo, FunctionLeave3WithInfo e FunctionTailcall3WithInfo di funzioni gestite.
Metodo SetFunctionIDMapper2 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. Questo metodo estende ICorProfilerInfo::SetFunctionIDMapper con un parametro che i profiler possono usare per evitare ambiguità tra i runtime.

Commenti

CLR implementa i metodi dell'interfaccia ICorProfilerInfo3 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 il file CorError.h.

CLR passa un'interfaccia ICorProfilerInfo3 a ogni profiler di codice durante l'inizializzazione, usando 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 di cui è in corso l'esecuzione sotto il controllo del runtime CLR.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: CorProf.idl, CorProf.h

Libreria: CorGuids.lib

Versioni di .NET Framework: Disponibile da 4

Vedi anche