Método de ICorProfilerCallback2::GarbageCollectionStarted

Artigo
08/08/2011

Notifica o criador de perfil de código que iniciou a coleta de lixo.

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 de generationCollected matriz.
generationCollected
[in] Uma matriz de valores booleanas, que são true se a geração que corresponde ao índice de matriz está sendo coletada por essa coleta de lixo; Caso contrário, false.

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

Comentários

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

Ele é seguro para o profiler 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 profiler deve considerar todas as identificações de objeto a ser inválido, até receber uma ICorProfilerCallback2::GarbageCollectionFinished retorno de chamada.