_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.