Compartir a través de

ICorProfilerCallback2::SurvivingReferences (Método)

  • Artículo

Informa del diseño de objetos del montón como resultado de una recolección de elementos no utilizados sin compactación.

Sintaxis

HRESULT SurvivingReferences(  
    [in] ULONG  cSurvivingObjectIDRanges,  
    [in, size_is(cSurvivingObjectIDRanges)] ObjectID  
                objectIDRangeStart[] ,  
    [in, size_is(cSurvivingObjectIDRanges)] ULONG  
                cObjectIDRangeLength[] );

Parámetros

cSurvivingObjectIDRanges
[in] Número de bloques de objetos contiguos que sobrevivieron como resultado de la recolección de elementos no utilizados sin compactación. Es decir, el valor de cSurvivingObjectIDRanges es el tamaño de las matrices objectIDRangeStart y cObjectIDRangeLength, que almacenan un ObjectID y una longitud, respectivamente, para cada bloque de objetos.

Los dos argumentos siguientes de SurvivingReferences son matrices paralelas. En otras palabras, objectIDRangeStart y cObjectIDRangeLength hacen referencia al mismo bloque de objetos contiguos.

objectIDRangeStart
[in] Matriz de valores ObjectID, cada uno de los cuales es la dirección inicial de un bloque de objetos activos y contiguos en la memoria.

cObjectIDRangeLength
[in] Matriz de enteros, cada uno de los cuales es el tamaño de un bloque superviviente de objetos contiguos en la memoria.

Se especifica un tamaño para cada bloque al que se hace referencia en la matriz objectIDRangeStart.

Comentarios

Importante

Este método notifica tamaños como MAX_ULONG para objetos de más de 4 GB en plataformas de 64 bits. Para los objetos mayores que 4 GB, use el método ICorProfilerCallback4::SurvivingReferences2 en su lugar.

Los elementos de las matrices objectIDRangeStart y cObjectIDRangeLength deben interpretarse del siguiente modo para determinar si un objeto ha sobrevivido a la recolección de elementos no utilizados. Supongamos que un valor ObjectID (ObjectID) se encuentra dentro del intervalo siguiente:

ObjectIDRangeStart[i]<= ObjectID<ObjectIDRangeStart[i] + cObjectIDRangeLength[i]

Para cualquier valor i que esté en el intervalo siguiente, el objeto sobrevivió a la recolección de elementos no utilizados:

0 <= i<cSurvivingObjectIDRanges

Una recolección de elementos no utilizados sin compactación recupera la memoria ocupada por objetos "inactivos", pero no compacta ese espacio liberado. Como consecuencia, la memoria se devuelve al montón pero no se mueve ningún objeto "activo".

Common Language Runtime (CLR) llama a SurvivingReferences para las recolecciones de elementos no utilizados sin compactación. Para las recolecciones de elementos no utilizados de compactación, se llama a ICorProfilerCallback::MovedReferences en su lugar. Se puede compactar una única recolección de elementos no utilizados para una generación y no compactar para otra. Para una recolección de elementos no utilizados en una generación determinada, el generador de perfiles recibirá una devolución de llamada SurvivingReferences o una devolución de llamada MovedReferences, pero no ambas.

Se pueden recibir varias devoluciones de llamada SurvivingReferences durante una recolección de elementos no utilizados determinada debido a un almacenamiento en búfer interno limitado, a la notificación de varios subprocesos en el caso de la recolección de elementos no utilizados de servidor, y a otros motivos. En el caso de varias devoluciones de llamada durante una recolección de elementos no utilizados, la información es acumulativa. Todas las referencias que se notifican en cualquier devolución de llamada SurvivingReferences sobreviven a la recolección de elementos no utilizados.

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

Consulte también