ICorProfilerCallback2::GarbageCollectionStarted 메서드

아티클
08/09/2011

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

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를 유효하지 않은 것으로 간주해야 합니다.