Interfaccia ICorProfilerInfo2

Fornisce metodi usati dai profiler di codice per comunicare con Common Language Runtime (CLR) per controllare il monitoraggio degli eventi e le informazioni sulle richieste. L'interfaccia ICorProfilerInfo2 è un'estensione dell'interfaccia ICorProfilerInfo . Ovvero, fornisce nuovi metodi supportati in .NET Framework versione 2.0 e versioni successive.

Metodi

Metodo Descrizione
Metodo DoStackSnapshot Illustra lo stack del thread specificato per segnalare i frame di chiamata gestiti al profiler.
Metodo EnumModuleFrozenObjects Ottiene un enumeratore che consente l'iterazione sugli oggetti bloccati nel modulo specificato.
Metodo GetAppDomainStaticAddress Ottiene l'indirizzo del campo statico del dominio applicazione specificato che si trova nell'ambito del dominio applicazione specificato.
Metodo GetArrayObjectInfo Ottiene informazioni dettagliate su un oggetto matrice.
Metodo GetBoxClassLayout Ottiene informazioni sul layout della classe per un tipo di valore specificato boxed.
Metodo GetClassFromTokenAndTypeArgs Ottiene l'oggetto ClassID di un tipo utilizzando il token di metadati specificato e i ClassID valori di qualsiasi argomento di tipo.
Metodo GetClassIDInfo2 Ottiene il modulo padre della classe generica specificata, il token di metadati per la classe , la classe padre e l'oggetto ClassIDClassID per ogni argomento di tipo, se presente, della classe .
Metodo GetClassLayout Ottiene le informazioni sul layout, in memoria, dei campi definiti dalla classe specificata. In altri termini, questo metodo ottiene gli offset dei campi della classe.
Metodo GetCodeInfo2 Ottiene gli ambiti del codice nativo associato al parametro FunctionID specificato.
Metodo GetContextStaticAddress Ottiene l'indirizzo del campo statico del contesto specificato nell'ambito del contesto specificato.
Metodo GetFunctionFromTokenAndTypeArgs Ottiene l'oggetto FunctionID di una funzione utilizzando il token di metadati specificato, contenente la classe e ClassID i valori di qualsiasi argomento di tipo.
Metodo GetFunctionInfo2 Ottiene la classe padre, il token di metadati e l'elemento ClassID di ciascun argomento di tipo, se presente, di una funzione.
Metodo GetGenerationBounds Ottiene le aree di memoria (segmenti dell'heap) che costituiscono le generazioni dell'heap di Garbage Collection.
Metodo GetNotifiedExceptionClauseInfo Ottiene l'indirizzo nativo e le informazioni sul frame per la clausola di eccezione (catch//finallyfilter) che sta per essere eseguita o che è stata appena eseguita.
Metodo GetObjectGeneration Ottiene il segmento dell'heap che contiene l'oggetto specificato.
Metodo GetRVAStaticAddress Ottiene l'indirizzo del campo RVA (Relative Virtual Address) specificato.
Metodo GetStaticFieldInfo Ottiene l'ambito in cui il campo specificato è statico.
Metodo GetStringLayout Ottiene informazioni sul layout di un oggetto stringa.
Metodo GetThreadAppDomain Ottiene l'ID del dominio applicazione in cui il thread specificato esegue il codice.
Metodo GetThreadStaticAddress Ottiene l'indirizzo del campo thread-static specificato che si trova nell'ambito del thread specificato.
Metodo SetEnterLeaveFunctionHooks2 Specifica le funzioni implementate dal profiler da chiamare in "enter", "leave" e "tailcall" hook di funzioni gestite.

Commenti

Un profiler chiama un metodo nell'interfaccia ICorProfilerInfo2 per comunicare con CLR per controllare il monitoraggio degli eventi e richiedere informazioni.

I metodi dell'interfaccia ICorProfilerInfo2 vengono implementati da CLR 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 ICorProfilerInfo2 a ogni profiler di codice durante l'inizializzazione, usando l'implementazione del profiler di ICorProfilerCallback::Initialize. Un profiler di codice può quindi chiamare i metodi dell'interfaccia ICorProfilerInfo2 per ottenere informazioni sul codice gestito eseguito sotto il controllo di CLR.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: CorProf.idl, CorProf.h

Libreria: CorGuids.lib

Versioni di .NET Framework: Disponibile dalla versione 2.0

Vedi anche