ICorProfilerCallback2::RootReferences2 方法

  • 發行項

在發生記憶體回收之後，通知分析工具有關根參考的資訊。 這個方法是 ICorProfilerCallback::RootReferences 方法的擴充。

語法

HRESULT RootReferences2(  
    [in] ULONG  cRootRefs,  
    [in, size_is(cRootRefs)] ObjectID rootRefIds[],  
    [in, size_is(cRootRefs)] COR_PRF_GC_ROOT_KIND rootKinds[],  
    [in, size_is(cRootRefs)] COR_PRF_GC_ROOT_FLAGS rootFlags[],  
    [in, size_is(cRootRefs)] UINT_PTR rootIds[]);

參數

cRootRefs
[in] rootRefIds、rootKinds、rootFlags 和 rootIds 陣列中的項目數。

rootRefIds
[in] 物件識別碼的陣列，每個識別碼都會參考靜態物件或堆疊上的物件。 rootKinds 陣列中的項目會提供資訊以供分類 rootRefIds 陣列中的對應項目。

rootKinds
[in] 指出記憶體回收根目錄型別的 COR_PRF_GC_ROOT_KIND 值陣列。

rootFlags
[in] 描述記憶體回收根目錄屬性之 COR_PRF_GC_ROOT_FLAGS 值的陣列。

rootIds
[in] UINT_PTR 值的陣列，這些值會指向包含記憶體回收根目錄相關資訊的整數 (取決於 rootKinds 參數的值)。

如果根目錄的型別是堆疊，則根目錄識別碼適用於包含變數的函式。 如果該根目錄識別碼為 0，則函式是 CLR 內部的未命名函式。 如果根目錄的型別是控制代碼，則根目錄識別碼適用於記憶體回收控制代碼。 若為其他根目錄類型，識別碼是不透明的值，應加以忽略。

備註

rootRefIds、rootKinds、rootFlags 和 rootIds 陣列是平行陣列。 也就是說，rootRefIds[i]、rootKinds[i]、rootFlags[i] 和 rootIds[i] 全都與相同的根目錄有關。

會同時呼叫 RootReferences 和 RootReferences2 來通知分析工具。 分析工具通常會實作其中一個方法，但不會同時實作這兩種方法，因為傳入 RootReferences2 的資訊是傳入 RootReferences 之資訊的超集。

rootRefIds 中的項目可以是零，這表示對應的根目錄參考是 null，而且不會參考受控堆積上的物件。

RootReferences2 在自行回呼期間所傳回的物件識別碼無效，因為記憶體回收可能正在將物件從舊位址移至新位址。 因此，分析工具不應嘗試在 RootReferences2 呼叫期間檢查物件。 呼叫 ICorProfilerCallback2::GarbageCollectionFinished 時，所有物件都已移至其新位置，因此可以安全地檢查。

規格需求

平台：請參閱系統需求。

標頭： CorProf.idl、CorProf.h

程式庫：CorGuids.lib

.NET Framework版本：自 2.0 起可用

另請參閱