COR_PRF_HIGH_MONITOR 列挙型COR_PRF_HIGH_MONITOR Enumeration

[.NET Framework 4.5.2 以降のバージョンでのみでサポート][Supported in the .NET Framework 4.5.2 and later versions]

プロファイラーが読み込み時にICorProfilerInfo5:: SetEventMask2メソッドに対して指定できる、 COR_PRF_MONITOR列挙に含まれるフラグだけでなく、フラグも提供します。Provides flags in addition to those found in the COR_PRF_MONITOR enumeration that the profiler can specify to the ICorProfilerInfo5::SetEventMask2 method when it is loading.

構文Syntax

typedef enum {  
    COR_PRF_HIGH_MONITOR_NONE                     = 0x00000000,  
    COR_PRF_HIGH_ADD_ASSEMBLY_REFERENCES          = 0x00000001,  
    COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED        = 0x00000002,
    COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS = 0x00000004,
    COR_PRF_HIGH_DISABLE_TIERED_COMPILATION       = 0x00000008,
    COR_PRF_HIGH_BASIC_GC                         = 0x00000010,
    COR_PRF_HIGH_MONITOR_GC_MOVED_OBJECTS         = 0x00000020,
    COR_PRF_HIGH_MONITOR_LARGEOBJECT_ALLOCATED    = 0x00000040,
    COR_PRF_HIGH_REQUIRE_PROFILE_IMAGE            = 0,  
    COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH           = COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED | 
                                                    COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS |
                                                    COR_PRF_HIGH_BASIC_GC |
                                                    COR_PRF_HIGH_MONITOR_GC_MOVED_OBJECTS |
                                                    COR_PRF_HIGH_MONITOR_LARGEOBJECT_ALLOCATED,  
    COR_PRF_HIGH_MONITOR_IMMUTABLE                = COR_PRF_HIGH_DISABLE_TIERED_COMPILATION  
} COR_PRF_HIGH_MONITOR;  

メンバーMembers

メンバーMember 説明Description
COR_PRF_HIGH_MONITOR_NONE フラグが設定されていません。No flags are set.
COR_PRF_HIGH_ADD_ASSEMBLY_REFERENCES CLR アセンブリ参照クロージャウォーク中にアセンブリ参照を追加するためのICorProfilerCallback6:: GetAssemblyReferenceコールバックを制御します。Controls the ICorProfilerCallback6::GetAssemblyReference callback for adding assembly references during the CLR assembly reference closure walk.
COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED メモリ内モジュールに関連付けられているシンボルストリームに更新するためのICorProfilerCallback7:: Moduleinmemorysymbol supcallbackを制御します。Controls the ICorProfilerCallback7::ModuleInMemorySymbolsUpdated callback for updates to the symbol stream associated with an in-memory module.
COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS 動的メソッドがガベージコレクションおよびアンロードされたことを示すICorProfilerCallback9::D ynamicmethodunloadedコールバックを制御します。Controls the ICorProfilerCallback9::DynamicMethodUnloaded callback for indicating when a dynamic method has been garbage collected and unloaded.
4.7.2 以降で利用可能Available since 4.7.2
COR_PRF_HIGH_DISABLE_TIERED_COMPILATION .NET Core 3.0 以降のバージョンのみ: プロファイラーの階層化されたコンパイルを無効にします。.NET Core 3.0 and later versions only: Disables tiered compilation for profilers.
COR_PRF_HIGH_BASIC_GC .NET Core 3.0 以降のバージョンのみ: COR_PRF_MONITOR_GCと比較して、軽量の GC プロファイルオプションを提供します。.NET Core 3.0 and later versions only: Provides a lightweight GC profiling option compared to COR_PRF_MONITOR_GC. GarbageCollectionStartedGarbageCollectionFinished、およびGetGenerationBoundsの各コールバックのみを制御します。Controls only the GarbageCollectionStarted, GarbageCollectionFinished, and GetGenerationBounds callbacks. COR_PRF_MONITOR_GC フラグとは異なり、COR_PRF_HIGH_BASIC_GC は同時実行ガベージコレクションを無効にしません。Unlike the COR_PRF_MONITOR_GC flag, COR_PRF_HIGH_BASIC_GC does not disable concurrent garbage collection.
COR_PRF_HIGH_MONITOR_GC_MOVED_OBJECTS .NET Core 3.0 以降のバージョンのみ: Gc を圧縮するために、 MovedreferencesMovedReferences2コールバックを有効にします。.NET Core 3.0 and later versions only: Enables the MovedReferences and MovedReferences2 callbacks for compacting GCs only.
COR_PRF_HIGH_MONITOR_LARGEOBJECT_ALLOCATED .NET Core 3.0 以降のバージョンのみ: COR_PRF_MONITOR_OBJECT_ALLOCATEDに似ていますが、ラージオブジェクトヒープ (LOH) に対してのみオブジェクト割り当てに関する情報を提供します。.NET Core 3.0 and later versions only: Similar to COR_PRF_MONITOR_OBJECT_ALLOCATED, but provides information on object allocations for the large object heap (LOH) only.
COR_PRF_HIGH_REQUIRE_PROFILE_IMAGE プロファイルが強化されたイメージを必要とするすべての COR_PRF_HIGH_MONITOR フラグを表しています。Represents all COR_PRF_HIGH_MONITOR flags that require profile-enhanced images. これは、 COR_PRF_MONITOR列挙の COR_PRF_REQUIRE_PROFILE_IMAGE フラグに対応します。It corresponds to the COR_PRF_REQUIRE_PROFILE_IMAGE flag in the COR_PRF_MONITOR enumeration.
COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH プロファイラーが実行中のアプリケーションに割り当てられた後に設定することが可能な、COR_PRF_HIGH_MONITOR のすべてのフラグを表します。Represents all COR_PRF_HIGH_MONITOR flags that can be set after the profiler is attached to a running app.
COR_PRF_HIGH_MONITOR_IMMUTABLE 初期化中にのみ設定可能な、COR_PRF_HIGH_MONITOR のすべてのフラグを表します。Represents all COR_PRF_HIGH_MONITOR flags that can be set only during initialization. 他の場所でこれらのフラグを変更しようとすると、エラーを表す HRESULT 値が生じます。Trying to change any of these flags elsewhere results in an HRESULT value that indicates failure.

コメントRemarks

COR_PRF_HIGH_MONITOR フラグは、 ICorProfilerInfo5:: GetEventMask2メソッドとICorProfilerInfo5:: SetEventMask2メソッドの pdwEventsHigh パラメーターと共に使用されます。The COR_PRF_HIGH_MONITOR flags are used with the pdwEventsHigh parameter of the ICorProfilerInfo5::GetEventMask2 and ICorProfilerInfo5::SetEventMask2 methods.

.NET Framework 4.6.1 以降では、COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH の値が0から COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED (0x00000002) に変更されました。Starting with the .NET Framework 4.6.1, the value of the COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH changed from 0 to COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED (0x00000002). .NET Framework 4.7.2 以降では、その値が COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED から COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED | COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADSに変更されました。Starting with the .NET Framework 4.7.2, its value changed from COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED to COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED | COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS.

COR_PRF_HIGH_MONITOR_IMMUTABLE は、初期化中にのみ設定できるすべてのフラグを表すビットマスクとして使用することを目的としています。COR_PRF_HIGH_MONITOR_IMMUTABLE is intended to be a bitmask that represents all flags that can only be set during initialization. これらのフラグを他の場所で変更しようとすると、失敗した HRESULTになります。Trying to change any of these flags elsewhere results in a failed HRESULT.

要件Requirements

:システム要件」を参照してください。Platforms: See System Requirements.

ヘッダー : CorProf.idl、CorProf.hHeader: CorProf.idl, CorProf.h

ライブラリ: CorGuids.libLibrary: CorGuids.lib

.NET Framework のバージョン: 4.5.2 以降で使用可能Available since 4.5.2.NET Framework Versions: 4.5.2 以降で使用可能Available since 4.5.2

参照See also