Compartilhar via


_CrtMemCheckpoint

Obtém o estado atual da pilha de depuração e armazena em um aplicativo-fornecido _CrtMemState estrutura (somente a versão de depuração).

void _CrtMemCheckpoint(
   _CrtMemState *state 
);

Parâmetros

  • state
    Ponteiro para _CrtMemState estrutura para preencher com o ponto de verificação de memória.

Comentários

O _CrtMemCheckpoint função cria um instantâneo do estado atual da pilha de depuração em um determinado momento.Esse instantâneo pode ser usado por outras funções de estado do heap, como _CrtMemCheckpoint para ajudar a detectar vazamentos de memória e outros problemas.Quando DEBUG não está definido, planos de _CrtMemState são removidos durante o pré-processamento.

O aplicativo deve passar um ponteiro para uma instância anteriormente alocada o _CrtMemState estrutura, definida em Crtdbg.h, o state parâmetro.Se _CrtMemCheckpoint encontra um erro durante a criação do ponto de verificação, a função gera um _CRT_WARN depurar um relatório descrevendo o problema.

Para obter mais informações sobre as funções do estado de pilha e o _CrtMemState estrutura, consulte Funções de emissão de relatórios do estado de heap.Para obter mais informações sobre como blocos de memória são alocados, inicializados e gerenciados na versão de depuração da pilha base, consulte Gerenciamento de memória e a pilha de depuração.

Se state é NULL, o manipulador de parâmetro inválido é invocado, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, errno, _doserrno, _sys_errlist e _sys_nerr for definido como EINVAL e a função retornará.

Requisitos

Rotina

Cabeçalho necessário

_CrtMemCheckpoint

<crtdbg.h>, <errno.h>

Para obter mais informações de compatibilidade, consulte Compatibilidade na introdução.

Bibliotecas: versões de depuração de Recursos da biblioteca CRT somente.

Exemplo

Consulte crt_dbg1.

Equivalência do .NET Framework

Não aplicável. Para chamar a função c padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.

Consulte também

Referência

Rotinas de depuração

_CrtMemCheckpoint