Delen via

opsomming COR_PRF_MONITOR

  • Artikel

Bevat waarden die worden gebruikt om gedrag, mogelijkheden of gebeurtenissen op te geven waarop de profiler zich wil abonneren.

Syntax

typedef enum {  
    COR_PRF_MONITOR_NONE                = 0x00000000,  
    COR_PRF_MONITOR_FUNCTION_UNLOADS    = 0x00000001,  
    COR_PRF_MONITOR_CLASS_LOADS         = 0x00000002,  
    COR_PRF_MONITOR_MODULE_LOADS        = 0x00000004,  
    COR_PRF_MONITOR_ASSEMBLY_LOADS      = 0x00000008,  
    COR_PRF_MONITOR_APPDOMAIN_LOADS     = 0x00000010,  
    COR_PRF_MONITOR_JIT_COMPILATION     = 0x00000020,  
    COR_PRF_MONITOR_EXCEPTIONS          = 0x00000040,  
    COR_PRF_MONITOR_GC                  = 0x00000080,  
    COR_PRF_MONITOR_OBJECT_ALLOCATED    = 0x00000100,  
    COR_PRF_MONITOR_THREADS             = 0x00000200,  
    COR_PRF_MONITOR_REMOTING            = 0x00000400,  
    COR_PRF_MONITOR_CODE_TRANSITIONS    = 0x00000800,  
    COR_PRF_MONITOR_ENTERLEAVE          = 0x00001000,  
    COR_PRF_MONITOR_CCW                 = 0x00002000,  
    COR_PRF_MONITOR_REMOTING_COOKIE     = 0x00004000 |
                                          COR_PRF_MONITOR_REMOTING,  
    COR_PRF_MONITOR_REMOTING_ASYNC      = 0x00008000 |
                                          COR_PRF_MONITOR_REMOTING,  
    COR_PRF_MONITOR_SUSPENDS            = 0x00010000,  
    COR_PRF_MONITOR_CACHE_SEARCHES      = 0x00020000,  
    COR_PRF_ENABLE_REJIT                = 0x00040000,  
    COR_PRF_ENABLE_INPROC_DEBUGGING     = 0x00080000,  
    COR_PRF_ENABLE_JIT_MAPS             = 0x00100000,  
    COR_PRF_DISABLE_INLINING            = 0x00200000,  
    COR_PRF_DISABLE_OPTIMIZATIONS       = 0x00400000,  
    COR_PRF_ENABLE_OBJECT_ALLOCATED     = 0x00800000,  
    COR_PRF_MONITOR_CLR_EXCEPTIONS      = 0x01000000,  
    COR_PRF_MONITOR_ALL                 = 0x0107FFFF,  
    COR_PRF_ENABLE_FUNCTION_ARGS        = 0X02000000,  
    COR_PRF_ENABLE_FUNCTION_RETVAL      = 0X04000000,  
    COR_PRF_ENABLE_FRAME_INFO           = 0X08000000,  
    COR_PRF_ENABLE_STACK_SNAPSHOT       = 0X10000000,  
    COR_PRF_USE_PROFILE_IMAGES          = 0x20000000,  
    COR_PRF_DISABLE_TRANSPARENCY_CHECKS_UNDER_FULL_TRUST  
                                        = 0x40000000,  
    COR_PRF_DISABLE_ALL_NGEN_IMAGES     = 0x80000000,  
    COR_PRF_ALL                         = 0x8FFFFFFF,  
    COR_PRF_REQUIRE_PROFILE_IMAGE       = COR_PRF_USE_PROFILE_IMAGES |
                                          COR_PRF_MONITOR_CODE_TRANSITIONS |
                                          COR_PRF_MONITOR_ENTERLEAVE,  
    COR_PRF_ALLOWABLE_AFTER_ATTACH      = COR_PRF_MONITOR_THREADS |  
                                          COR_PRF_MONITOR_MODULE_LOADS |  
                                          COR_PRF_MONITOR_ASSEMBLY_LOADS |  
                                          COR_PRF_MONITOR_APPDOMAIN_LOADS |  
                                          COR_PRF_ENABLE_STACK_SNAPSHOT |  
                                          COR_PRF_MONITOR_GC |  
                                          COR_PRF_MONITOR_SUSPENDS |  
                                          COR_PRF_MONITOR_CLASS_LOADS |  
                                          COR_PRF_MONITOR_JIT_COMPILATION,  
    COR_PRF_MONITOR_IMMUTABLE           = COR_PRF_MONITOR_CODE_TRANSITIONS |  
                                          COR_PRF_MONITOR_REMOTING |  
                                          COR_PRF_MONITOR_REMOTING_COOKIE |  
                                          COR_PRF_MONITOR_REMOTING_ASYNC |  
                                          COR_PRF_ENABLE_REJIT |  
                                          COR_PRF_ENABLE_INPROC_DEBUGGING |  
                                          COR_PRF_ENABLE_JIT_MAPS |  
                                          COR_PRF_DISABLE_OPTIMIZATIONS |  
                                          COR_PRF_DISABLE_INLINING |  
                                          COR_PRF_ENABLE_OBJECT_ALLOCATED |  
                                          COR_PRF_ENABLE_FUNCTION_ARGS |  
                                          COR_PRF_ENABLE_FUNCTION_RETVAL |  
                                          COR_PRF_ENABLE_FRAME_INFO |  
                                          COR_PRF_USE_PROFILE_IMAGES |  
                     COR_PRF_DISABLE_TRANSPARENCY_CHECKS_UNDER_FULL_TRUST |  
                                          COR_PRF_DISABLE_ALL_NGEN_IMAGES  
} COR_PRF_MONITOR;

Leden

In de volgende secties worden opsommingsleden per categorie vermeld COR_PRF_MONITOR . De categorieën zijn:

Er zijn geen vlaggen ingesteld

Lid Beschrijving
COR_PRF_MONITOR_NONE Er worden geen vlaggen ingesteld.

Terugbelvlagmen

Lid Beschrijving
COR_PRF_MONITOR_ALL Hiermee schakelt u alle callback-gebeurtenissen in.
COR_PRF_MONITOR_APPDOMAIN_LOADS Hiermee beheert u de AppDomainCreation* callbacks en AppDomainShutdown* in de interface ICorProfilerCallback .
COR_PRF_MONITOR_ASSEMBLY_LOADS Hiermee beheert u de AssemblyLoad* callbacks en AssemblyUnload* in de interface ICorProfilerCallback .
COR_PRF_MONITOR_CACHE_SEARCHES Hiermee beheert u de JITCachedFunctionSearch* callbacks in de interface ICorProfilerCallback .

Het gedrag van deze vlag is gewijzigd in .NET Framework versie 2.0.
COR_PRF_MONITOR_CCW Hiermee beheert u de COMClassicVTable* callbacks in de interface ICorProfilerCallback .
COR_PRF_MONITOR_CLASS_LOADS Hiermee beheert u de ClassLoad* callbacks en ClassUnload* in de interface ICorProfilerCallback .
COR_PRF_MONITOR_CLR_EXCEPTIONS Hiermee beheert u de ExceptionCLRCatcher* callbacks in de interface ICorProfilerCallback .
COR_PRF_MONITOR_CODE_TRANSITIONS Bepaalt de callbacks UnmanagedToManagedTransition en ManagedToUnmanagedTransition in de interface ICorProfilerCallback
COR_PRF_MONITOR_ENTERLEAVE Hiermee beheert u de FunctionEnter*FunctionLeave*, en FunctionTailCall*profilering van globale statische functies.
COR_PRF_MONITOR_EXCEPTIONS Bepaalt de ExceptionThrown-callback en de ExceptionSearch*callbacks , ExceptionOSHandler*ExceptionUnwind*, en ExceptionCatcher* in de ICorProfilerCallback-interface.
COR_PRF_MONITOR_FUNCTION_UNLOADS Hiermee bepaalt u de FunctionUnloadStarted-callback in de ICorProfilerCallback-interface .
COR_PRF_MONITOR_GC Beheert de callbacks GarbageCollectionStarted, GarbageCollectionFinished, MovedReferences, MovedReferences2, SurvivingReferences, SurvivingReferences2, ObjectReferences, ObjectsAllocatedByClass, RootReferences, RootReferences2, HandleCreated, HandleDestroyed en FinalizeableObjectQueued in de ICorProfilerCallback* interfaces. Wanneer COR_PRF_MONITOR_GC is toegewezen, wordt gelijktijdige garbagecollection uitgeschakeld.
COR_PRF_MONITOR_JIT_COMPILATION Hiermee worden de JITCompilation*callbacks , JITFunctionPitched en JITInlining in de ICorProfilerCallback-interface beheerd .
COR_PRF_MONITOR_MODULE_LOADS Beheert de ModuleLoad*ModuleUnload*, en ModuleAttachedToAssembly-callbacks in de ICorProfilerCallback-interface.
COR_PRF_MONITOR_OBJECT_ALLOCATED Hiermee bepaalt u de callback ObjectAllocated in de interface ICorProfilerCallback .
COR_PRF_MONITOR_REMOTING Hiermee beheert u de Remoting* callbacks in de interface ICorProfilerCallback .
COR_PRF_MONITOR_REMOTING_ASYNC Hiermee bepaalt u of de Remoting* callbacks asynchrone gebeurtenissen bewaken.
COR_PRF_MONITOR_REMOTING_COOKIE Hiermee bepaalt u of een cookie wordt doorgegeven aan de Remoting* callbacks.
COR_PRF_MONITOR_SUSPENDS Bepaalt de RuntimeSuspend*callbacks , RuntimeResume*, RuntimeThreadSuspended en RuntimeThreadResumed in de ICorProfilerCallback-interface.
COR_PRF_MONITOR_THREADS Hiermee bepaalt u de callbacks ThreadCreated, ThreadDestroyed, ThreadAssignedToOSThread en ThreadNameChanged in de interfaces ICorProfilerCallback en ICorProfilerCallback2 .

Markeringen voor het inschakelen van functies

Lid Beschrijving
COR_PRF_ENABLE_FRAME_INFO Hiermee schakelt u het ophalen van een exacte ClassID waarde voor een algemene functie in door de methode GetFunctionInfo2 aan te roepen met een COR_PRF_FRAME_INFO waarde die wordt geretourneerd door de functionEnter2-callback .
COR_PRF_ENABLE_FUNCTION_ARGS Hiermee schakelt u argumenttracering in met behulp van de callback functionEnter2 of de callback FunctionEnter3WithInfo en de getFunctionEnter3Info-methode .
COR_PRF_ENABLE_FUNCTION_RETVAL Hiermee schakelt u tracering van retourwaarden in met behulp van de callback-methode FunctionLeave2 of de callback-methode FunctionLeave3WithInfo en GetFunctionLeave3Info .
COR_PRF_ENABLE_INPROC_DEBUGGING Afgeschaft.

Foutopsporing in het proces wordt niet ondersteund. Deze vlag heeft geen effect.
COR_PRF_ENABLE_JIT_MAPS Afgeschaft.

Hiermee kan de profiler il-naar-systeemeigen kaarten verkrijgen met behulp van GetILToNativeMapping. Vanaf .NET Framework 2.0 houdt de runtime altijd IL-naar-systeemeigen kaarten bij. Daarom wordt deze vlag altijd beschouwd als ingesteld.
COR_PRF_ENABLE_OBJECT_ALLOCATED Informeert de runtime dat de profiler mogelijk objecttoewijzingsmeldingen wil ontvangen. Deze vlag moet worden ingesteld tijdens de initialisatie. Hiermee kan de profiler vervolgens de COR_PRF_MONITOR_OBJECT_ALLOCATED vlag gebruiken om ObjectAllocated callbacks te ontvangen.
COR_PRF_ENABLE_REJIT Hiermee schakelt u aanroepen naar de methoden RequestReJIT en RequestRevert in. De profiler moet deze vlag instellen bij het opstarten. Als de profiler deze vlag opgeeft, moet deze ook opgeven COR_PRF_DISABLE_ALL_NGEN_IMAGES.
COR_PRF_ENABLE_STACK_SNAPSHOT Hiermee schakelt u aanroepen naar de methode DoStackSnapshot in.

Configuratievlagken

Lid Beschrijving
COR_PRF_DISABLE_ALL_NGEN_IMAGES Hiermee voorkomt u dat alle systeemeigen afbeeldingen (inclusief afbeeldingen met profiler) worden geladen. Als deze vlag en de COR_PRF_USE_PROFILE_IMAGES vlag beide zijn opgegeven, COR_PRF_DISABLE_ALL_NGEN_IMAGES wordt gebruikt.
COR_PRF_DISABLE_INLINING Hiermee schakelt u alle inlining uit.
COR_PRF_DISABLE_OPTIMIZATIONS Hiermee schakelt u alle code-optimalisaties uit.
COR_PRF_DISABLE_TRANSPARENCY_CHECKS_UNDER_FULL_TRUST Hiermee worden controles op de transparantie van de beveiliging uitgeschakeld die normaal gesproken worden uitgevoerd tijdens JIT-compilatie (Just-In-Time) en het laden van klassen voor assembly's met volledig vertrouwen. Hierdoor kunnen sommige instrumentaties eenvoudiger worden uitgevoerd.
COR_PRF_USE_PROFILE_IMAGES Zorgt ervoor dat de systeemeigen afbeeldingen zoeken naar afbeeldingen met profiler. Als er geen met profiler verbeterde installatiekopieën wordt gevonden voor een bepaalde assembly, valt de runtime van de algemene taal terug op JIT voor die assembly. Als deze vlag en de COR_PRF_DISABLE_ALL_NGEN_IMAGES vlag beide zijn opgegeven, COR_PRF_DISABLE_ALL_NGEN_IMAGES wordt gebruikt.

Samengestelde vlaggen

Lid Beschrijving
COR_PRF_ALL Vertegenwoordigt alle COR_PRF_MONITOR vlagwaarden.
COR_PRF_ALLOWABLE_AFTER_ATTACH Vertegenwoordigt alle COR_PRF_MONITOR vlaggen die kunnen worden ingesteld nadat de profiler is gekoppeld aan een actieve app. De syntaxissectie geeft de afzonderlijke vlaggen aan die aanwezig zijn in dit bitmasker.
COR_PRF_MONITOR_ALL Hiermee schakelt u alle callback-gebeurtenissen in.
COR_PRF_MONITOR_IMMUTABLE Vertegenwoordigt alle COR_PRF_MONITOR vlaggen die alleen tijdens de initialisatie kunnen worden ingesteld. Als u een van deze vlaggen probeert te wijzigen na de initialisatie, wordt een HRESULT waarde geretourneerd die een fout aangeeft.
COR_PRF_REQUIRE_PROFILE_IMAGE Vertegenwoordigt alle COR_PRF_MONITOR vlaggen waarvoor profielverbewerkte afbeeldingen zijn vereist.

Opmerkingen

Een COR_PRF_MONITOR waarde wordt gebruikt met de methoden ICorProfilerInfo::GetEventMask en ICorProfilerInfo::SetEventMask om de gebeurtenismeldingen te definiëren die de gemeenschappelijke taalruntime aan de profiler maakt.

Vereisten

Platforms: Zie Systeemvereisten.

Header: CorProf.idl, CorProf.h

Bibliotheek: CorGuids.lib

.NET Framework versies: beschikbaar sinds 1.0

Zie ook