COR_PRF_MONITOR Numaralandırması

  • Makale

Profil oluşturucunun abone olmak istediği davranışı, özellikleri veya olayları belirtmek için kullanılan değerleri içerir.

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;

Üyeler

Aşağıdaki bölümlerde numaralandırma üyeleri kategoriye göre listelemektedir COR_PRF_MONITOR . Kategoriler şunlardır:

Bayrak ayarlanmadı

Üye Description
COR_PRF_MONITOR_NONE Hiçbir bayrak ayarlanmadı.

Geri çağırma bayrakları

Üye Description
COR_PRF_MONITOR_ALL Tüm geri çağırma olaylarını etkinleştirir.
COR_PRF_MONITOR_APPDOMAIN_LOADS AppDomainCreation*ICorProfilerCallback arabirimindeki ve AppDomainShutdown* geri çağırmalarını denetler.
COR_PRF_MONITOR_ASSEMBLY_LOADS AssemblyLoad*ICorProfilerCallback arabirimindeki ve AssemblyUnload* geri çağırmalarını denetler.
COR_PRF_MONITOR_CACHE_SEARCHES JITCachedFunctionSearch*ICorProfilerCallback arabirimindeki geri çağırmaları denetler.

Bu bayrağın davranışı .NET Framework sürüm 2.0'da değiştirilir.
COR_PRF_MONITOR_CCW COMClassicVTable*ICorProfilerCallback arabirimindeki geri çağırmaları denetler.
COR_PRF_MONITOR_CLASS_LOADS ClassLoad*ICorProfilerCallback arabirimindeki ve ClassUnload* geri çağırmalarını denetler.
COR_PRF_MONITOR_CLR_EXCEPTIONS ExceptionCLRCatcher*ICorProfilerCallback arabirimindeki geri çağırmaları denetler.
COR_PRF_MONITOR_CODE_TRANSITIONS ICorProfilerCallback arabirimindeki UnmanagedToManagedTransition ve ManagedToUnmanagedTransition geri çağırmalarını denetler
COR_PRF_MONITOR_ENTERLEAVE FunctionEnter*, FunctionLeave*ve FunctionTailCall*profil oluşturma genel statik işlevlerini denetler.
COR_PRF_MONITOR_EXCEPTIONS ExceptionThrown geri çağırmasını ExceptionSearch*ve ICorProfilerCallback arabirimindeki , ExceptionOSHandler*, ExceptionUnwind*ve ExceptionCatcher* geri çağırmalarını denetler.
COR_PRF_MONITOR_FUNCTION_UNLOADS ICorProfilerCallback arabiriminde FunctionUnloadStarted geri çağırmasını denetler.
COR_PRF_MONITOR_GC Arabirimlerdeki GarbageCollectionStarted, GarbageCollectionFinished, MovedReferences, MovedReferences2, SurvivingReferences, SurvivingReferences2, ObjectReferences, ObjectsAllocatedByClass, RootReferences, RootReferences2, HandleCreated, HandleDestroyed ve FinalizeableObjectQueued geri çağrılarını ICorProfilerCallback* denetler. Ayrıldığında COR_PRF_MONITOR_GC , eş zamanlı çöp toplama kapatılır.
COR_PRF_MONITOR_JIT_COMPILATION JITCompilation*ICorProfilerCallback arabiriminde , JITFunctionPitched ve JITInlining geri çağırmalarını denetler.
COR_PRF_MONITOR_MODULE_LOADS ModuleLoad*ICorProfilerCallback arabirimindeki , ModuleUnload*ve ModuleAttachedToAssembly geri çağrılarını denetler.
COR_PRF_MONITOR_OBJECT_ALLOCATED ICorProfilerCallback arabiriminde ObjectAllocated geri çağırmasını denetler.
COR_PRF_MONITOR_REMOTING Remoting*ICorProfilerCallback arabirimindeki geri çağırmaları denetler.
COR_PRF_MONITOR_REMOTING_ASYNC Geri çağırmaların Remoting* zaman uyumsuz olayları izleyip izlemeyeceğini denetler.
COR_PRF_MONITOR_REMOTING_COOKIE Tanımlama bilgisinin geri çağırmalara Remoting* geçirilip geçirilmeyeceğini denetler.
COR_PRF_MONITOR_SUSPENDS ICorProfilerCallback arabirimindeki RuntimeSuspend*, RuntimeResume*, RuntimeThreadSuspended ve RuntimeThreadResumed geri çağırmalarını denetler.
COR_PRF_MONITOR_THREADS ICorProfilerCallback ve ICorProfilerCallback2 arabirimlerindeki ThreadCreated, ThreadDestroyed, ThreadAssignedToOSThread ve ThreadNameChanged geri çağrılarını denetler.

Özellik etkinleştirme bayrakları

Üye Description
COR_PRF_ENABLE_FRAME_INFO FunctionEnter2 geri çağırması tarafından döndürülen bir değerle GetFunctionInfo2 yöntemini çağırarak genel bir işlev için tam ClassID bir COR_PRF_FRAME_INFO alma işlemini etkinleştirir.
COR_PRF_ENABLE_FUNCTION_ARGS FunctionEnter2 geri çağırmasını veya FunctionEnter3WithInfo geri çağırmasını ve GetFunctionEnter3Info yöntemini kullanarak bağımsız değişken izlemeyi etkinleştirir.
COR_PRF_ENABLE_FUNCTION_RETVAL FunctionLeave2 geri çağırmasını veya FunctionLeave3WithInfo geri çağırmasını ve GetFunctionLeave3Info yöntemini kullanarak dönüş değerlerinin izlemeyi etkinleştirir.
COR_PRF_ENABLE_INPROC_DEBUGGING Kullanım dışı.

İşlemde hata ayıklama desteklenmez. Bu bayrağın hiçbir etkisi yok.
COR_PRF_ENABLE_JIT_MAPS Kullanım dışı.

Profil oluşturucunun GetILToNativeMapping kullanarak IL'den yerel haritalara sahip olmasını sağlar. .NET Framework 2.0'dan başlayarak, çalışma zamanı her zaman IL'den yerele eşlemeleri izler; bu nedenle, bu bayrak her zaman ayarlanmış olarak kabul edilir.
COR_PRF_ENABLE_OBJECT_ALLOCATED Çalışma zamanına, profil oluşturucunun nesne ayırma bildirimleri isteyebileceğini bildirir. Bu bayrak başlatma sırasında ayarlanmalıdır. Profil oluşturucunun daha sonra ObjectAllocated geri çağırmalarını almak için bayrağını kullanmasına COR_PRF_MONITOR_OBJECT_ALLOCATED izin verir.
COR_PRF_ENABLE_REJIT RequestReJIT ve RequestRevert yöntemlerine çağrıları etkinleştirir. Profil oluşturucunun başlangıçta bu bayrağı ayarlaması gerekir. Profil oluşturucu bu bayrağı belirtiyorsa, ayrıca belirtmelidir COR_PRF_DISABLE_ALL_NGEN_IMAGES.
COR_PRF_ENABLE_STACK_SNAPSHOT DoStackSnapshot yöntemine çağrıları etkinleştirir.

Yapılandırma bayrakları

Üye Description
COR_PRF_DISABLE_ALL_NGEN_IMAGES Tüm yerel görüntülerin (profil oluşturucu tarafından geliştirilmiş görüntüler dahil) yüklenmesini engeller. Bu bayrağın ve bayrağın COR_PRF_USE_PROFILE_IMAGES her ikisi de belirtilirse kullanılır COR_PRF_DISABLE_ALL_NGEN_IMAGES .
COR_PRF_DISABLE_INLINING Tüm inlining'i devre dışı bırakır.
COR_PRF_DISABLE_OPTIMIZATIONS Tüm kod iyileştirmelerini devre dışı bırakır.
COR_PRF_DISABLE_TRANSPARENCY_CHECKS_UNDER_FULL_TRUST Tam güven derlemeleri için tam zamanında (JIT) derleme ve sınıf yükleme sırasında normalde yapılan güvenlik saydamlığı denetimlerini devre dışı bırakır. Bu, bazı izleme işlemlerinin gerçekleştirilmesini kolaylaştırabilir.
COR_PRF_USE_PROFILE_IMAGES Yerel görüntü aramasının profil oluşturucu tarafından geliştirilmiş görüntüleri aramasına neden olur. Belirli bir derleme için profil oluşturucu tarafından geliştirilmiş görüntü bulunamazsa, ortak dil çalışma zamanı bu derleme için JIT'ye geri döner. Bu bayrağın ve bayrağın COR_PRF_DISABLE_ALL_NGEN_IMAGES her ikisi de belirtilirse kullanılır COR_PRF_DISABLE_ALL_NGEN_IMAGES .

Bileşik bayraklar

Üye Description
COR_PRF_ALL Tüm COR_PRF_MONITOR bayrak değerlerini temsil eder.
COR_PRF_ALLOWABLE_AFTER_ATTACH Profil oluşturucu çalışan bir uygulamaya eklendikten sonra ayarlanabilen tüm COR_PRF_MONITOR bayrakları temsil eder. Söz dizimi bölümü, bu bit maskesinde bulunan tek tek bayrakları gösterir.
COR_PRF_MONITOR_ALL Tüm geri çağırma olaylarını etkinleştirir.
COR_PRF_MONITOR_IMMUTABLE Yalnızca başlatma sırasında ayarlanabilen tüm COR_PRF_MONITOR bayrakları temsil eder. Başlatmadan sonra bu bayraklardan herhangi birini değiştirmeye çalışmak, hataya işaret eden bir HRESULT değer döndürür.
COR_PRF_REQUIRE_PROFILE_IMAGE Profil geliştirilmiş görüntüler gerektiren tüm COR_PRF_MONITOR bayrakları temsil eder.

Açıklamalar

COR_PRF_MONITOR Ortak dil çalışma zamanının profil oluşturucuya yaptığı olay bildirimlerini tanımlamak için ICorProfilerInfo::GetEventMask ve ICorProfilerInfo::SetEventMask yöntemleriyle bir değer kullanılır.

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: CorProf.idl, CorProf.h

Kitaplığı: CorGuids.lib

.NET Framework Sürümleri: 1.0 sürümünden itibaren kullanılabilir

Ayrıca bkz.