Interfaccia ICorProfilerInfo3
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
