ICorProfilerCallback::MovedReferences 메서드

  • 아티클

압축 가비지 수집의 결과로 힙에 있는 개체의 새 레이아웃을 보고하려고 호출됩니다.

구문

HRESULT MovedReferences(  
    [in]  ULONG  cMovedObjectIDRanges,  
    [in, size_is(cMovedObjectIDRanges)] ObjectID oldObjectIDRangeStart[] ,  
    [in, size_is(cMovedObjectIDRanges)] ObjectID newObjectIDRangeStart[] ,  
    [in, size_is(cMovedObjectIDRanges)] ULONG    cObjectIDRangeLength[] );

매개 변수

cMovedObjectIDRanges
[in] 압축 가비지 컬렉션 후에 이동된 연속 개체 블록 수입니다. 즉, cMovedObjectIDRanges 값은 oldObjectIDRangeStart, newObjectIDRangeStart 및 cObjectIDRangeLength 배열의 총 크기입니다.

MovedReferences의 다음 세 인수는 병렬 배열입니다. 즉, oldObjectIDRangeStart[i], newObjectIDRangeStart[i] 및 cObjectIDRangeLength[i]는 모두 단일 연속 개체 블록과 관련이 있습니다.

oldObjectIDRangeStart
[in] 메모리에서 연속 라이브 개체 블록의 이전(가비지 수집 전) 시작 주소를 각각 나타내는 ObjectID 값의 배열입니다.

newObjectIDRangeStart
[in] 메모리에서 연속 라이브 개체 블록의 새(가비지 컬렉션 후) 시작 주소를 각각 나타내는 ObjectID 값의 배열입니다.

cObjectIDRangeLength
[in] 메모리의 연속 개체 블록의 크기를 각각 나타내는 정수 배열입니다.

크기는 oldObjectIDRangeStart 및 newObjectIDRangeStart 배열에서 참조된 각 블록에 대해 지정됩니다.

설명

중요

이 메서드는 64비트 플랫폼에서 4GB보다 큰 개체의 크기를 MAX_ULONG으로 보고합니다. 4GB보다 큰 개체의 크기를 가져오려면 ICorProfilerCallback4::MovedReferences2 메서드를 대신 사용합니다.

압축 가비지 수집기는 데드 개체가 사용한 메모리를 회수하고 확보된 공간을 압축합니다. 따라서 라이브 개체가 힙 내에서 이동될 수 있고 이전 알림으로 분산된 ObjectID 값이 변경될 수 있습니다.

기존 ObjectID 값(oldObjectID)이 다음 범위 내에 있다고 가정합니다.

oldObjectIDRangeStart[i]<= oldObjectID<oldObjectIDRangeStart[i] + cObjectIDRangeLength[i]

이 경우 범위 시작부터 개체 시작까지 오프셋은 다음과 같습니다.

oldObjectID - oldObjectRangeStart[i]

다음 범위에 있는 i 값에 대해

0 <= i<cMovedObjectIDRanges

새 ObjectID를 다음과 같이 계산할 수 있습니다.

newObjectID = newObjectIDRangeStart[i] + (oldObjectID – oldObjectIDRangeStart[i])

콜백 자체가 진행되는 동안 MovedReferences를 통해 전달된 ObjectID 값은 유효하지 않습니다. 가비지 수집이 이전 위치에서 새 위치로 개체를 이동하는 중일 수 있기 때문입니다. 그러므로 프로파일러는 MovedReferences 호출 중에 개체 검사를 시도하지 않아야 합니다. ICorProfilerCallback2::GarbageCollectionFinished 콜백은 모든 개체가 새 위치로 이동되었고 검사가 수행될 수 있음을 나타냅니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: CorProf.idl, CorProf.h

라이브러리: CorGuids.lib

.NET Framework 버전: 2.0부터 사용 가능

참고 항목