COR_PRF_MONITOR uppräkning

Artikel
05/10/2023

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
Motringningsflaggor
Funktionsaktiveringsflaggor
Konfigurationsflaggor
Sammansatta flaggor

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 , `FunctionEnterFunctionLeave`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

Dela via