ICorProfilerCallback2::GarbageCollectionStarted (Método)
Notifica al generador de perfiles del código que se ha iniciado la recolección de elementos no utilizados.
Sintaxis
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 de la matriz generationCollected.
generationCollected
[in] Matriz de valores booleanos, que son true si la generación que corresponde al índice de matriz lo recopila esta recolección de elementos no utilizados; de lo contrario, son false.
Un valor de la enumeración COR_PRF_GC_GENERATION, que indica la generación, indexa la matriz.
reason
[in] Valor de la enumeración COR_PRF_GC_REASON que indica el motivo por el que se ha inducido 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 correspondiente de ICorProfilerCallback2::GarbageCollectionFinished. Estas devoluciones de llamada no deben producirse en el mismo subproceso.
Es seguro que el generador de perfiles inspeccione los objetos en sus ubicaciones originales durante la devolución de llamada de GarbageCollectionStarted. El recolector de elementos no utilizados comenzará a mover objetos después de la devolución de GarbageCollectionStarted. Después de que el generador de perfiles haya devuelto un valor de esta devolución de llamada, el generador de perfiles debe tener en cuenta que todos los id. de objeto no son válidos hasta que recibe una devolución de llamada de ICorProfilerCallback2::GarbageCollectionFinished.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: CorProf.idl, CorProf.h
Biblioteca: CorGuids.lib
Versiones de .NET Framework: disponible a partir de la versión 2.0
