Compartir a través de

ICorProfilerCallback2::GarbageCollectionStarted (Método)

Notifica al generador de perfiles de código que la recolección de elementos no utilizados ha comenzado.

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

Parámetros

  • cGenerations
    [in] Número total de entradas en la matriz generationCollected.

  • generationCollected
    [in] Matriz de valores booleanos, que son true si esta recolección de elementos no utilizados va a recopilar la generación que corresponde al índice de matriz; de lo contrario, son false.

    La matriz se indiza mediante un valor de la enumeración COR_PRF_GC_GENERATION, que indica la generación.

  • reason
    [in] Valor de la enumeración COR_PRF_GC_REASON que indica la razón que indujo la recolección de elementos no utilizados.

Comentarios

Todas las devoluciones de llamada que pertenecen a esta recolección de elementos no utilizados se producirán entre la devolución de llamada de GarbageCollectionStarted y la devolución de llamada de ICorProfilerCallback2::GarbageCollectionFinished correspondiente. No es necesario que estas devoluciones de llamada se produzcan en el mismo subproceso.

El generador de perfiles puede inspeccionar de manera segura los objetos en sus ubicaciones originales durante la devolución de llamada GarbageCollectionStarted. El recolector de elementos no utilizados empezará a mover los objetos después de regresar de GarbageCollectionStarted. Después de que el generador de perfiles regresa de esta devolución de llamada, no debería considerar que los identificadores de objeto son válidos hasta que reciba una devolución de llamada ICorProfilerCallback2::GarbageCollectionFinished.

Requisitos

Plataformas: vea Requisitos de sistema de .NET Framework.

Encabezado: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

Versiones de .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vea también

Referencia

ICorProfilerCallback (Interfaz)

ICorProfilerCallback2 (Interfaz)