Interfaccia ICorProfilerInfo3ICorProfilerInfo3 Interface

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.Provides methods that code profilers use to communicate with the common language runtime (CLR) to control event monitoring and to request information. Il ICorProfilerInfo3 interfaccia è un'estensione del ICorProfilerInfo2 interfaccia.The ICorProfilerInfo3 interface is an extension of the ICorProfilerInfo2 interface. Fornisce nuovi metodi supportati in .NET Framework 4.NET Framework 4 e versioni successive.It provides new methods supported in the .NET Framework 4.NET Framework 4 and later versions.

MetodiMethods

MetodoMethod DescrizioneDescription
Metodo EnumJITedFunctionsEnumJITedFunctions Method Restituisce un enumeratore per tutte le funzioni sottoposte in precedenza a compilazione JIT.Returns an enumerator for all previously JIT-compiled functions.
Metodo EnumModulesEnumModules Method Restituisce un enumeratore che fornisce i metodi per scorrere in sequenza una raccolta di moduli gestiti caricati nell'applicazione.Returns an enumerator that provides methods to sequentially iterate through a collection of managed modules that are loaded into the application.
Metodo GetAppDomainsContainingModuleGetAppDomainsContainingModule Method Ottiene gli identificatori dei domini dell'applicazione in cui è stato caricato il modulo specificato.Gets the identifiers of the application domains in which the given module has been loaded.
Metodo GetFunctionEnter3InfoGetFunctionEnter3Info Method Fornisce le informazioni sullo stack frame e l'argomento della funzione da segnalare al profiler tramite la FunctionEnter3WithInfo funzione; può essere chiamato solo durante la FunctionEnter3WithInfo callback.Provides the stack frame and argument information of the function that is being reported to the profiler by the FunctionEnter3WithInfo function; can be called only during the FunctionEnter3WithInfo callback.
Metodo GetFunctionLeave3InfoGetFunctionLeave3Info Method Fornisce lo stack frame e il valore restituito della funzione da segnalare al profiler tramite la funzione FunctionLeave3WithInfo funzione; può essere chiamato solo durante la FunctionLeave3WithInfo callback.Provides the stack frame and return value of the function that is being reported to the profiler by the FunctionLeave3WithInfo function function; can be called only during the FunctionLeave3WithInfo callback.
Metodo GetFunctionTailcall3InfoGetFunctionTailcall3Info Method Fornisce lo stack frame della funzione da segnalare al profiler tramite la FunctionTailcall3WithInfo funzione; può essere chiamato solo durante la FunctionTailcall3WithInfo callback.Provides the stack frame of the function that is being reported to the profiler by the FunctionTailcall3WithInfo function; can be called only during the FunctionTailcall3WithInfo callback.
Metodo GetModuleInfo2GetModuleInfo2 Method 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.Given a module ID, returns the file name of the module, the ID of the module's parent assembly, and a bitmask that describes the properties of the module.
Metodo GetRuntimeInformationGetRuntimeInformation Method Fornisce informazioni sulla versione relative al runtime che viene profilato.Provides version information about the runtime that is being profiled.
Metodo GetStringLayout2GetStringLayout2 Method Ottiene informazioni sul layout di un oggetto stringa.Gets information about the layout of a string object.
Metodo GetThreadStaticAddress2GetThreadStaticAddress2 Method Ottiene l'indirizzo del campo statico a livello di thread specificato che è nell'ambito del dominio dell'applicazione e del thread specificati.Gets the address of the specified thread-static field that is in the scope of the specified thread and application domain.
Metodo RequestProfilerDetachRequestProfilerDetach Method Indica al runtime di disconnettere il profiler.Instructs the runtime to detach the profiler.
Metodo SetEnterLeaveFunctionHooks3SetEnterLeaveFunctionHooks3 Method Specifica le funzioni implementate dal profiler che verranno chiamate sul FunctionEnter3, FunctionLeave3, e FunctionTailcall3 funzioni.Specifies the profiler-implemented functions that will be called on the FunctionEnter3, FunctionLeave3, and FunctionTailcall3 functions.
Metodo SetEnterLeaveFunctionHooks3WithInfoSetEnterLeaveFunctionHooks3WithInfo Method Specifica le funzioni implementate dal profiler che verranno chiamate sul FunctionEnter3WithInfo, FunctionLeave3WithInfo, e FunctionTailcall3WithInfo hook di funzioni gestite.Specifies the profiler-implemented functions that will be called on the FunctionEnter3WithInfo, FunctionLeave3WithInfo, and FunctionTailcall3WithInfo hooks of managed functions.
Metodo SetFunctionIDMapper2SetFunctionIDMapper2 Method 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.Specifies the profiler-implemented function that will be called to map FunctionID values to alternative values, which are passed to the profiler's function entry/exit hooks. Questo metodo estende ICorProfilerInfo:: SetFunctionIDMapper con un parametro che i profiler possono utilizzare per distinguere tra runtime.This method extends ICorProfilerInfo::SetFunctionIDMapper with a parameter that profilers may use to disambiguate among runtimes.

NoteRemarks

CLR implementa i metodi dell'interfaccia ICorProfilerInfo3 usando il modello a thread libero.The CLR implements the methods of the ICorProfilerInfo3 interface by using the free-threaded model. Ogni metodo restituisce un valore HRESULT per indicare esito positivo o negativo.Each method returns an HRESULT to indicate success or failure. Per un elenco dei possibili codici restituiti, vedere il file CorError.h.For a list of possible return codes, see the CorError.h file.

CLR passa un' ICorProfilerInfo3 interfaccia a ogni code profiler durante l'inizializzazione, mediante l'implementazione del profiler di ICorProfilerCallback:: Initialize o ICorProfilerCallback3::I nitializeForAttach metodo.The CLR passes an ICorProfilerInfo3 interface to each code profiler during initialization, using the profiler's implementation of the ICorProfilerCallback::Initialize or ICorProfilerCallback3::InitializeForAttach method. 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.A code profiler can then call the ICorProfilerInfo3 methods to get information about managed code that is being executed under the control of the CLR.

RequisitiRequirements

Piattaforme: vedere requisiti di sistema.Platforms: See System Requirements.

Intestazione: CorProf.idl, CorProf.hHeader: CorProf.idl, CorProf.h

Libreria: CorGuids. libLibrary: CorGuids.lib

Versioni di .NET framework: Disponibile dalla 4Available since 4.NET Framework Versions: Disponibile dalla 4Available since 4

Vedere ancheSee Also

Interfacce di profilaturaProfiling Interfaces
Interfaccia ICorProfilerInfoICorProfilerInfo Interface