Compartilhar via

Método ICorProfilerCallback2::GarbageCollectionStarted

  • Artigo

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

Sintaxe

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 na generationCollected matriz.

generationCollected
[in] Uma matriz de valores booleanos, que são true se a geração que corresponde ao índice da matriz está sendo coletada por essa coleta de lixo; por outro lado, false.

A matriz é indexada por um valor da enumeração COR_PRF_GC_GENERATION, que indica a geração.

reason
[in] Um valor da enumeração COR_PRF_GC_REASON que indica o motivo pelo qual a coleta de lixo foi induzida.

Comentários

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

É seguro para o criador de perfil inspecionar objetos em seus locais originais durante o GarbageCollectionStarted retorno de chamada. O coletor de lixo começará a mover objetos após o retorno do GarbageCollectionStarted. Depois que o criador de perfil retornar desse retorno de chamada, o criador de perfil deverá considerar todos os IDs de objeto como inválidos até receber um ICorProfilerCallback2::GarbageCollectionFinished retorno de chamada.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: disponíveis desde 2.0

Confira também