ICorProfilerCallback2::GarbageCollectionStarted 메서드

  • 아티클

가비지 수집이 시작되었음을 코드 프로파일러에 알립니다.

구문

HRESULT GarbageCollectionStarted(  
    [in] int cGenerations,  
    [in, size_is(cGenerations), length_is(cGenerations)] BOOL generationCollected[],  
    [in] COR_PRF_GC_REASON reason);

매개 변수

cGenerations
[in] generationCollected 배열의 총 항목 수입니다.

generationCollected
[in] 배열 인덱스에 해당하는 생성이 이 가비지 수집에 의해 수집되는 경우인 부울 값 true의 배열입니다. 그렇지 않으면 false입니다.

배열은 생성을 나타내는 COR_PRF_GC_GENERATION 열거형 값으로 인덱싱됩니다.

reason
[in] 가비지 수집이 유도된 이유를 나타내는 COR_PRF_GC_REASON 열거형의 값입니다.

설명

이 가비지 수집과 관련된 모든 콜백은 GarbageCollectionStarted 콜백과 해당 ICorProfilerCallback2::GarbageCollectionFinished 콜백 사이에 발생합니다. 이러한 콜백이 꼭 동일한 스레드에서 발생할 필요는 없습니다.

GarbageCollectionStarted 콜백 중 프로파일러가 원래 위치에 있는 개체를 검사하는 것이 안전합니다. 가비지 수집기는 GarbageCollectionStarted에서 반환 후 개체 이동을 시작합니다. 프로파일러가 이 콜백에서 반환된 후 프로파일러는 ICorProfilerCallback2::GarbageCollectionFinished 콜백을 받을 때까지 모든 개체 ID를 유효하지 않은 것으로 간주합니다.

요구 사항

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

헤더: CorProf.idl, CorProf.h

라이브러리: CorGuids.lib

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

참고 항목