COR_PRF_MONITOR uppräkning

  • Artikel

Innehåller värden som används för att ange beteende, funktioner eller händelser som profileraren vill prenumerera på.

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;

Medlemmar

I följande avsnitt listas COR_PRF_MONITOR uppräkningsmedlemmar efter kategori. Kategorierna är:

Inga flaggor har angetts

Medlem Description
COR_PRF_MONITOR_NONE Inga flaggor har angetts.

Motringningsflaggor

Medlem Description
COR_PRF_MONITOR_ALL Aktiverar alla återanropshändelser.
COR_PRF_MONITOR_APPDOMAIN_LOADS Styr återanropen AppDomainCreation* och AppDomainShutdown* i gränssnittet ICorProfilerCallback .
COR_PRF_MONITOR_ASSEMBLY_LOADS Styr återanropen AssemblyLoad* och AssemblyUnload* i gränssnittet ICorProfilerCallback .
COR_PRF_MONITOR_CACHE_SEARCHES Styr återanropen JITCachedFunctionSearch* i gränssnittet ICorProfilerCallback .

Den här flaggans beteende ändras i .NET Framework version 2.0.
COR_PRF_MONITOR_CCW Styr återanropen COMClassicVTable* i gränssnittet ICorProfilerCallback .
COR_PRF_MONITOR_CLASS_LOADS Styr återanropen ClassLoad* och ClassUnload* i gränssnittet ICorProfilerCallback .
COR_PRF_MONITOR_CLR_EXCEPTIONS Styr återanropen ExceptionCLRCatcher* i gränssnittet ICorProfilerCallback .
COR_PRF_MONITOR_CODE_TRANSITIONS Styr återanropen UnmanagedToManagedTransition och ManagedToUnmanagedTransition i gränssnittet ICorProfilerCallback
COR_PRF_MONITOR_ENTERLEAVE Styr , FunctionEnter*FunctionLeave*och FunctionTailCall*profilering av globala statiska funktioner.
COR_PRF_MONITOR_EXCEPTIONS Styr återanropet ExceptionThrown och ExceptionSearch*, ExceptionOSHandler*, ExceptionUnwind*och ExceptionCatcher* motringningar i gränssnittet ICorProfilerCallback .
COR_PRF_MONITOR_FUNCTION_UNLOADS Styr functionUnloadStarted callback i gränssnittet ICorProfilerCallback .
COR_PRF_MONITOR_GC Styr GarbageCollectionStarted, GarbageCollectionFinished, MovedReferences, MovedReferences2, SurvivingReferences, SurvivingReferences2, ObjectReferences, ObjectsAllocatedByClass, RootReferences, RootReferences2, HandleCreated, HandleDestroyed och FinalizeableObjectQueued callbacks i gränssnitten ICorProfilerCallback* . När COR_PRF_MONITOR_GC allokeras inaktiveras samtidig skräpinsamling.
COR_PRF_MONITOR_JIT_COMPILATION JITCompilation*Styr , JITFunctionPitched och JITInlining-återanrop i gränssnittet ICorProfilerCallback.
COR_PRF_MONITOR_MODULE_LOADS Styr återanropen ModuleLoad*, ModuleUnload*, och ModuleAttachedToAssembly i gränssnittet ICorProfilerCallback .
COR_PRF_MONITOR_OBJECT_ALLOCATED Styr återanropet ObjectAllocated i gränssnittet ICorProfilerCallback .
COR_PRF_MONITOR_REMOTING Styr återanropen Remoting* i gränssnittet ICorProfilerCallback .
COR_PRF_MONITOR_REMOTING_ASYNC Styr om återanropen Remoting* ska övervaka asynkrona händelser.
COR_PRF_MONITOR_REMOTING_COOKIE Styr om en cookie skickas till återanropen Remoting* .
COR_PRF_MONITOR_SUSPENDS Styr återanropen RuntimeSuspend*, RuntimeResume*, RuntimeThreadSuspended och RuntimeThreadResumed i gränssnittet ICorProfilerCallback .
COR_PRF_MONITOR_THREADS Styr återanropen ThreadCreated, ThreadDestroyed, ThreadAssignedToOSThread och ThreadNameChanged i gränssnitten ICorProfilerCallback och ICorProfilerCallback2 .

Funktionsaktiveringsflaggor

Medlem Description
COR_PRF_ENABLE_FRAME_INFO Aktiverar hämtning av en exakt ClassID för en allmän funktion genom att anropa metoden GetFunctionInfo2 med ett COR_PRF_FRAME_INFO värde som returneras av FunctionEnter2-återanropet .
COR_PRF_ENABLE_FUNCTION_ARGS Aktiverar spårning av argument med hjälp av FunctionEnter2-återanropet eller FunctionEnter3WithInfo-återanropet och metoden GetFunctionEnter3Info .
COR_PRF_ENABLE_FUNCTION_RETVAL Aktiverar spårning av returvärden med hjälp av metoden FunctionLeave2-återanrop eller metoden FunctionLeave3WithInfo och GetFunctionLeave3Info .
COR_PRF_ENABLE_INPROC_DEBUGGING Inaktuellt.

Felsökning av processer stöds inte. Den här flaggan har ingen effekt.
COR_PRF_ENABLE_JIT_MAPS Inaktuellt.

Gör att profileraren kan hämta IL-till-native-kartor med hjälp av GetILToNativeMapping. Från och med .NET Framework 2.0 spårar körningen alltid IL-till-native-kartor. Därför anses den här flaggan alltid vara inställd.
COR_PRF_ENABLE_OBJECT_ALLOCATED Informerar körningen om att profileraren kanske vill ha meddelanden om objektallokering. Den här flaggan måste anges under initieringen. Det gör att profileraren därefter kan använda COR_PRF_MONITOR_OBJECT_ALLOCATED flaggan för att ta emot objectAllocated-återanrop .
COR_PRF_ENABLE_REJIT Aktiverar anrop till metoderna RequestReJIT och RequestRevert . Profileraren måste ange den här flaggan vid start. Om profileraren anger den här flaggan måste den också ange COR_PRF_DISABLE_ALL_NGEN_IMAGES.
COR_PRF_ENABLE_STACK_SNAPSHOT Aktiverar anrop till metoden DoStackSnapshot .

Konfigurationsflaggor

Medlem Description
COR_PRF_DISABLE_ALL_NGEN_IMAGES Förhindrar att alla inbyggda avbildningar (inklusive profileringsförbättrade bilder) läses in. Om både den här flaggan och COR_PRF_USE_PROFILE_IMAGES flaggan har angetts COR_PRF_DISABLE_ALL_NGEN_IMAGES används.
COR_PRF_DISABLE_INLINING Inaktiverar all inlining.
COR_PRF_DISABLE_OPTIMIZATIONS Inaktiverar alla kodoptimeringar.
COR_PRF_DISABLE_TRANSPARENCY_CHECKS_UNDER_FULL_TRUST Inaktiverar kontroller av säkerhetstransparens som normalt görs vid JIT-kompilering (just-in-time) och klassinläsning för sammansättningar med fullständigt förtroende. Detta kan göra vissa instrumentation enklare att utföra.
COR_PRF_USE_PROFILE_IMAGES Gör att den inbyggda bildsökningen söker efter profilerareförbättrade bilder. Om ingen profilerförbättrad avbildning hittas för en viss sammansättning återgår den gemensamma språkkörningen till JIT för den sammansättningen. Om både den här flaggan och COR_PRF_DISABLE_ALL_NGEN_IMAGES flaggan har angetts COR_PRF_DISABLE_ALL_NGEN_IMAGES används.

Sammansatta flaggor

Medlem Description
COR_PRF_ALL Representerar alla COR_PRF_MONITOR flaggvärden.
COR_PRF_ALLOWABLE_AFTER_ATTACH Representerar alla COR_PRF_MONITOR flaggor som kan anges när profileraren har kopplats till en app som körs. Syntaxavsnittet anger de enskilda flaggor som finns i den här bitmasken.
COR_PRF_MONITOR_ALL Aktiverar alla återanropshändelser.
COR_PRF_MONITOR_IMMUTABLE Representerar alla COR_PRF_MONITOR flaggor som endast kan anges under initieringen. Om du försöker ändra någon av dessa flaggor efter initieringen returneras ett HRESULT värde som indikerar fel.
COR_PRF_REQUIRE_PROFILE_IMAGE Representerar alla COR_PRF_MONITOR flaggor som kräver profilförbättrade bilder.

Kommentarer

Ett COR_PRF_MONITOR värde används med metoderna ICorProfilerInfo::GetEventMask och ICorProfilerInfo::SetEventMask för att definiera de händelsemeddelanden som den vanliga språkkörningen gör till profileraren.

Krav

Plattformar: Se Systemkrav.

Huvudet: CorProf.idl, CorProf.h

Bibliotek: CorGuids.lib

.NET Framework versioner: Tillgänglig sedan 1.0

Se även