COR_PRF_HIGH_MONITOR 列挙型

  • [アーティクル]

[.NET Framework 4.5.2 以降のバージョンでのみでサポート]

ローディング中に ICorProfilerInfo5::SetEventMask2 メソッドに対してプロファイラーが指定できる COR_PRF_MONITOR 列挙型の内容の他に、フラグを提供します。

構文

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;

メンバー

メンバー 説明
COR_PRF_HIGH_MONITOR_NONE フラグが設定されていません。
COR_PRF_HIGH_ADD_ASSEMBLY_REFERENCES CLR アセンブリ参照クロージャ ウォーク中にアセンブリ参照を追加するための ICorProfilerCallback6::GetAssemblyReference コールバックを制御します。
COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED メモリ内モジュールに関連付けられているシンボル ストリームに対する更新のための ICorProfilerCallback7::ModuleInMemorySymbolsUpdated コールバックを制御します。
COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS 動的メソッドがいつガベージ コレクトされてアンロードされたかを示すための ICorProfilerCallback9::DynamicMethodUnloaded コールバックを制御します。
4.7.2 以降で利用可能
COR_PRF_HIGH_DISABLE_TIERED_COMPILATION .NET Core 3.0 以降のバージョンのみ: プロファイラーの階層型コンパイルを無効にします。
COR_PRF_HIGH_BASIC_GC .NET Core 3.0 以降のバージョンのみ: COR_PRF_MONITOR_GC と比べて軽量な GC プロファイリング オプションを提供します。 GarbageCollectionStarted、GarbageCollectionFinished、GetGenerationBounds の各コールバックのみを制御します。 COR_PRF_MONITOR_GC フラグとは異なり、COR_PRF_HIGH_BASIC_GC では同時実行ガベージ コレクションは無効にされません。
COR_PRF_HIGH_MONITOR_GC_MOVED_OBJECTS .NET Core 3.0 以降のバージョンのみ: GC を圧縮するためにのみ、MovedReferences および MovedReferences2 コールバックを有効にします。
COR_PRF_HIGH_MONITOR_LARGEOBJECT_ALLOCATED .NET Core 3.0 以降のバージョンのみ: COR_PRF_MONITOR_OBJECT_ALLOCATED に似ていますが、ラージ オブジェクト ヒープ (LOH) に対してのみ、オブジェクト割り当てに関する情報を提供します。
COR_PRF_HIGH_REQUIRE_PROFILE_IMAGE プロファイルが強化されたイメージを必要とするすべての COR_PRF_HIGH_MONITOR フラグを表しています。 これは、COR_PRF_MONITOR 列挙型の COR_PRF_REQUIRE_PROFILE_IMAGE フラグに対応します。
COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH プロファイラーが実行中のアプリケーションに割り当てられた後に設定することが可能な、COR_PRF_HIGH_MONITOR のすべてのフラグを表します。
COR_PRF_HIGH_MONITOR_IMMUTABLE 初期化中にのみ設定可能な、COR_PRF_HIGH_MONITOR のすべてのフラグを表します。 他の場所でこれらのフラグを変更しようとすると、エラーを表す HRESULT 値が生じます。

解説

COR_PRF_HIGH_MONITOR フラグは、ICorProfilerInfo5::GetEventMask2 および ICorProfilerInfo5::SetEventMask2 メソッドの pdwEventsHigh パラメーターと共に使用します。

.NET Framework 4.6.1 以降では、COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH の値が 0 から 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 に変更されました。

COR_PRF_HIGH_MONITOR_IMMUTABLE は、初期化中にのみ設定できるすべてのフラグを表すビットマスクとなることを意図したものです。 これらのフラグを他の場所で変更しようとすると、HRESULT が失敗します。

必要条件

:「システム要件」を参照してください。

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

ライブラリ: CorGuids.lib

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

関連項目