Compartilhar via


Configurando o rastreamento de referência de objeto

Você pode usar o Gflags para habilitar, desabilitar e configurar o recurso rastreamento de referência de objeto do Windows. O Rastreamento de Referência de Objeto registra rastreamentos de pilha sequenciais sempre que um contador de referência de objeto é incrementado ou decrementado. Os rastreamentos podem ajudá-lo a detectar erros de referência de objeto, incluindo desreferência dupla, falha na referência e falha na desreferência de objetos. Esse recurso tem suporte apenas no Windows Vista e em versões posteriores do Windows. Para obter informações detalhadas sobre esse recurso, consulte Rastreamento de referência de objeto.

Para habilitar o rastreamento de referência de objeto

  1. Na caixa de diálogo Gflags, selecione a guia Registro do Sistema ou a guia Sinalizadores do Kernel .

  2. Na seção Rastreamento de Referência de Objeto, selecione Habilitar.

    Você deve limitar o rastreamento a objetos com marcas de pool especificadas, a objetos criados por um processo especificado ou ambos.

  3. Para limitar o rastreamento a objetos com uma marca de pool específica, digite o nome da marca do pool. Para listar várias marcas de pool, use ponto-e-vírgula (;) para separar as marcas de pool. Quando você lista várias marcas de pool, o rastreamento inclui objetos com qualquer uma das marcas de pool especificadas. As marcas de pool diferenciam maiúsculas de minúsculas. Use os comandos !pool e !poolfind depurador para determinar nomes de pool.

    Por exemplo, Fred; Tag1.

  4. Para limitar o rastreamento a objetos criados por um processo específico, digite o nome da imagem do processo. Você pode especificar apenas um nome de arquivo de imagem.

    Quando você especifica marcas de pool e um processo, o rastreamento inclui objetos criados pelo processo que têm qualquer uma das marcas de pool especificadas.

  5. Para manter o rastreamento depois que o objeto de rastreamento for destruído, selecione Permanente.

    Quando você seleciona Permanente, o rastreamento é retido até que você desabilite o rastreamento de referência de objeto ou desligue ou reinicie o Windows.

  6. Clique em Aplicar ou em OK.

A captura de tela a seguir mostra o Rastreamento de Referência de Objeto habilitado na guia Sinalizadores do Kernel .

Captura de tela do rastreamento de referência de objeto habilitado na guia Sinalizadores do Kernel na caixa de diálogo Gflags.

Esse rastreamento incluirá apenas objetos que foram criados pelo processo de notepad.exe que têm a marca de pool Fred ou Tag1. Como essa é uma configuração de tempo de execução (sinalizadores de kernel), o rastreamento é iniciado imediatamente. Se fosse uma configuração do Registro, você teria que reiniciar o Windows para iniciar o rastreamento.

Para desabilitar o rastreamento de referência de objeto

  1. Na caixa de diálogo Gflags, selecione a guia Registro do Sistema ou a guia Sinalizadores do Kernel . O Rastreamento de Referência de Objeto aparecerá na última guia somente no Windows Vista e nas versões posteriores do Windows.

  2. Na seção Rastreamento de Referência de Objeto, desmarque a caixa Habilitar marcar.