COR_PRF_MONITOR 列舉

發行項
05/10/2023

包含值，這些值用於指定分析工具想要訂閱的行為、功能或事件。

語法

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;

成員

下列各節會依類別列出 COR_PRF_MONITOR 列舉成員。這些類別包括：

未設定旗標
回呼旗標
功能啟用旗標
組態旗標
組合旗標

未設定旗標

member	描述
`COR_PRF_MONITOR_NONE`	沒有設定旗標。

回呼旗標

member	描述
`COR_PRF_MONITOR_ALL`	啟用所有回呼事件。
`COR_PRF_MONITOR_APPDOMAIN_LOADS`	控制 ICorProfilerCallback 介面中的 `AppDomainCreation` 和 `AppDomainShutdown` 回呼。
`COR_PRF_MONITOR_ASSEMBLY_LOADS`	控制 ICorProfilerCallback 介面中的 `AssemblyLoad` 和 `AssemblyUnload` 回呼。
`COR_PRF_MONITOR_CACHE_SEARCHES`	控制 ICorProfilerCallback 介面中的 `JITCachedFunctionSearch*` 回呼。此旗標的行為在 2.0 版.NET Framework變更。
`COR_PRF_MONITOR_CCW`	控制 ICorProfilerCallback 介面中的 `COMClassicVTable*` 回呼。
`COR_PRF_MONITOR_CLASS_LOADS`	控制 ICorProfilerCallback 介面中的 `ClassLoad` 和 `ClassUnload` 回呼。
`COR_PRF_MONITOR_CLR_EXCEPTIONS`	控制 ICorProfilerCallback 介面中的 `ExceptionCLRCatcher*` 回呼。
`COR_PRF_MONITOR_CODE_TRANSITIONS`	控制 ICorProfilerCallback 介面中的 UnmanagedToManagedTransition 和 ManagedToUnmanagedTransition 回呼
`COR_PRF_MONITOR_ENTERLEAVE`	控制 `FunctionEnter`、`FunctionLeave` 和 `FunctionTailCall*` 分析全域靜態函式。
`COR_PRF_MONITOR_EXCEPTIONS`	控制 ICorProfilerCallback 介面中的 ExceptionThrown 回呼和 `ExceptionSearch`、`ExceptionOSHandler`、`ExceptionUnwind` 及 `ExceptionCatcher` 回呼。
`COR_PRF_MONITOR_FUNCTION_UNLOADS`	控制 ICorProfilerCallback 介面中的 FunctionUnloadStarted 回呼。
`COR_PRF_MONITOR_GC`	控制 `ICorProfilerCallback*` 介面中的 GarbageCollectionStarted、GarbageCollectionFinished、MovedReferences、MovedReferences2、SurvivingReferences、SurvivingReferences2、ObjectReferences、ObjectsAllocatedByClass、RootReferences、RootReferences2、HandleCreated、HandleDestroyed 和 FinalizeableObjectQueued 回呼。當配置 `COR_PRF_MONITOR_GC` 時，會關閉並行記憶體回收。
`COR_PRF_MONITOR_JIT_COMPILATION`	控制 ICorProfilerCallback 介面中的 `JITCompilation*`、JITFunctionPitched 和 JITInlining 回呼。
`COR_PRF_MONITOR_MODULE_LOADS`	控制 ICorProfilerCallback 介面中的 `ModuleLoad`、`ModuleUnload` 和 ModuleAttachedToAssembly 回呼。
`COR_PRF_MONITOR_OBJECT_ALLOCATED`	可控制 ICorProfilerCallback 介面中的 ObjectAllocated 回呼。
`COR_PRF_MONITOR_REMOTING`	控制 ICorProfilerCallback 介面中的 `Remoting*` 回呼。
`COR_PRF_MONITOR_REMOTING_ASYNC`	控制 `Remoting*` 回呼是否會監視非同步事件。
`COR_PRF_MONITOR_REMOTING_COOKIE`	控制 Cookie 是否傳遞至 `Remoting*` 回呼。
`COR_PRF_MONITOR_SUSPENDS`	控制 ICorProfilerCallback 介面中的 `RuntimeSuspend`、`RuntimeResume`、RuntimeThreadSuspended 和 RuntimeThreadResumed 回呼。
`COR_PRF_MONITOR_THREADS`	控制 ICorProfilerCallback 和 ICorProfilerCallback2 介面中的 ThreadCreated、ThreadDestroyed、ThreadAssignedToOSThread 和 ThreadNameChanged 回呼。

功能啟用旗標

member	描述
`COR_PRF_ENABLE_FRAME_INFO`	啟用透過搭配 FunctionEnter2 回呼所傳回的 `COR_PRF_FRAME_INFO` 值呼叫 GetFunctionInfo2 方法，擷取泛型函式的確切 `ClassID`。
`COR_PRF_ENABLE_FUNCTION_ARGS`	啟用使用 FunctionEnter2 回呼，或 FunctionEnter3WithInfo 回呼及 GetFunctionEnter3Info 方法追蹤引數。
`COR_PRF_ENABLE_FUNCTION_RETVAL`	啟用使用 FunctionLeave2 回呼，或 FunctionLeave3WithInfo 回呼和 GetFunctionLeave3Info 方法追蹤傳回值。
`COR_PRF_ENABLE_INPROC_DEBUGGING`	已取代。不支援同處理序偵錯。此旗標無效。
`COR_PRF_ENABLE_JIT_MAPS`	已取代。允許分析工具使用 GetILToNativeMapping 取得 IL 與原生 (IL-to-native) 的對應。從 .NET Framework 2.0 開始，執行時間一律會追蹤 IL 到原生對應;因此，一律會將此旗標視為設定。
`COR_PRF_ENABLE_OBJECT_ALLOCATED`	通知執行階段，分析工具可能想要物件配置通知。必須在初始化期間設定此旗標。這可讓分析工具在後續使用 `COR_PRF_MONITOR_OBJECT_ALLOCATED` 旗標接收 ObjectAllocated 回呼。
`COR_PRF_ENABLE_REJIT`	啟用呼叫 RequestReJIT 和 RequestRevert 方法。分析工具必須在啟動時設定此旗標。若分析工具指定此旗標，則必須也要指定 `COR_PRF_DISABLE_ALL_NGEN_IMAGES`。
`COR_PRF_ENABLE_STACK_SNAPSHOT`	啟用呼叫 DoStackSnapshot 方法。

組態旗標

member	描述
`COR_PRF_DISABLE_ALL_NGEN_IMAGES`	防止載入所有原生映像 (包含分析工具增強型映像)。若指定此旗標及 `COR_PRF_USE_PROFILE_IMAGES` 旗標，則使用 `COR_PRF_DISABLE_ALL_NGEN_IMAGES`。
`COR_PRF_DISABLE_INLINING`	停用所有內嵌。
`COR_PRF_DISABLE_OPTIMIZATIONS`	停用所有程式碼最佳化。
`COR_PRF_DISABLE_TRANSPARENCY_CHECKS_UNDER_FULL_TRUST`	針對完全信任組件，停用通常在 Just-in-time (JIT) 編譯及類別載入期間完成的安全性透明度檢查。這可讓一些實作更容易執行。
`COR_PRF_USE_PROFILE_IMAGES`	使原生映像搜尋尋找分析工具增強型映像。若沒有找到指定組件的分析工具增強型映像，Common Language Runtime 會回復為該組件的 JIT。若指定此旗標及 `COR_PRF_DISABLE_ALL_NGEN_IMAGES` 旗標，則使用 `COR_PRF_DISABLE_ALL_NGEN_IMAGES`。

組合旗標

member	描述
`COR_PRF_ALL`	代表所有 `COR_PRF_MONITOR` 旗標值。
`COR_PRF_ALLOWABLE_AFTER_ATTACH`	代表所有 `COR_PRF_MONITOR` 旗標，這些旗標可在分析工具連結至執行中的應用程式之後加以設定。語法區段指出此位元遮罩中存在的個別旗標。
`COR_PRF_MONITOR_ALL`	啟用所有回呼事件。
`COR_PRF_MONITOR_IMMUTABLE`	代表所有 `COR_PRF_MONITOR` 旗標，這些旗標只能在初始化期間加以設定。嘗試在初始化之後變更任何這些旗標，會傳回指出失敗的 `HRESULT` 值。
`COR_PRF_REQUIRE_PROFILE_IMAGE`	代表需要設定檔增強影像的所有 `COR_PRF_MONITOR` 旗標。

備註

COR_PRF_MONITOR 值可用於搭配 ICorProfilerInfo::GetEventMask 和 ICorProfilerInfo::SetEventMask 方法，定義 Common Language Runtime 建立給分析工具的事件通知。

規格需求

平台：請參閱系統需求。

標頭： CorProf.idl、CorProf.h

程式庫：CorGuids.lib

.NET Framework版本：自 1.0 起可用

共用方式為