Método ICorProfilerCallback::RootReferences
Notifica o criador de perfil com informações sobre referências raiz após a coleta de lixo.
HRESULT RootReferences(
[in] ULONG cRootRefs,
[in, size_is(cRootRefs)] ObjectID rootRefIds[] );
Parâmetros
cRootRefs
[in] O número de referências no rootRefIds matriz.rootRefIds
[in] Uma matriz de identificadores de objetos que fazem referência a um objeto estático ou um objeto na pilha.
Comentários
Ambos os RootReferences e ICorProfilerCallback2::RootReferences2 são chamados para notificar o criador de perfil. Geradores de perfis normalmente implementará uma ou Outros, mas não ambos, porque as informações passadas em RootReferences2 é um superconjunto do que passado RootReferences.
É possível que o rootRefIds matriz para conter um objeto nulo. Por exemplo, todas sistema autônomo referências de objeto declaradas na pilha são tratadas sistema autônomo raízes pelo coletor de lixo e serão sempre relatadas.
O objeto retornados por IDsRootReferences inválido são válido durante o retorno de chamada, porque a coleta de lixo pode estar no meio da movimentação de objetos de endereços antigos para novos endereços. Portanto, geradores de perfis não devem tentar inspecionar objetos durante um RootReferences Chame. Quando ICorProfilerCallback2::GarbageCollectionFinished é chamado, todos os objetos foram movidos para seus novos locais e podem ser olhados com segurança.
Requisitos
Plataformas: See Requisitos de sistema do .NET framework.
Cabeçalho: CorProf.idl
Biblioteca: CorGuids.lib
.NET Framework Versions: 3.5 SP1, 3,5, 3.0 SP1, 3.0, 2.0 SP1, 2.0