Método ICorProfilerCallback2::GarbageCollectionStarted

Artigo
08/25/2010

Notifica o criador de perfil de código que lixo coleção foi iniciado.

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

Parâmetros

cGenerations
[in] O número total de entradas no generationCollected matriz.
generationCollected
[in] Uma matriz de valores booleanas, que são true Se a geração que corresponde ao índice da matriz está sendo coletada por esse lixo coleção; caso contrário, false.

A matriz é indexada por um valor igual a COR_PRF_GC_GENERATION enumeração, que indica a geração.
reason
[in] Um valor igual a COR_PRF_GC_REASON enumeração que indica o motivo pelo qual o lixo coleção foi induzido.

Comentários

Todos os retornos de chamada que pertencem a essa coleta de lixo ocorrerá entre o GarbageCollectionStarted retorno de chamada e o correspondente ICorProfilerCallback2::GarbageCollectionFinishedretorno de chamada . Esses retornos de chamada não precisam ocorrer no mesmo thread.

Ele é seguro para o criador de perfil inspecionar os objetos em seus locais originais durante o GarbageCollectionStarted retorno de chamada. O coletor de lixo começará a movimentação de objetos após o retorno do GarbageCollectionStarted. Depois que o profiler retornou desse retorno de chamada, o criador de perfil deve considerar todas as identificações de objeto ser inválido até que receba um ICorProfilerCallback2::GarbageCollectionFinished retorno de chamada.