_CrtMemDumpStatistics
Despejos informações de cabeçalho de depuração para um estado especificado do heap em um formato legível usuário (versão de depuração somente).
void _CrtMemDumpStatistics(
const _CrtMemState *state
);
Parâmetros
- state
Ponteiro para o estado de heap para despejar.
Comentários
A função de _CrtMemDumpStatistics despeja informações de cabeçalho de depuração para um estado especificado do heap em um formato legível usuário. As estatísticas de despejo podem ser usadas pelo aplicativo controlar alocações e detectar problemas de memória. O estado de memória pode conter um estado específico do heap ou a diferença entre dois estados. Quando _DEBUG não está definido, as chamadas para _CrtMemDumpStatistics são removidas durante o pré-processamento.
O parâmetro de state deve ser um ponteiro para uma estrutura de _CrtMemState que está preenchida por _CrtMemCheckpoint ou retornada por _CrtMemDifference antes de _CrtMemDumpStatistics ser chamado. Se state é NULL, o parâmetro de manipulador inválido é invocado, como descrito em Validação do parâmetro. Se a execução for permitida continuar, errno está definido como EINVAL e nenhuma ação é executada. Para obter mais informações, consulte errno, _doserrno, _sys_errlist e _sys_nerr.
Para obter mais informações sobre as funções de estado da heap e a estrutura de _CrtMemState, consulte Funções de relatório sobre o estado da heap. Para obter mais informações sobre como os blocos de memória são atribuídos, inicializados, e gerenciados na versão de depuração da heap de base, consulte Detalhes da pilha de depuração CRT.
Requisitos
Rotina |
Cabeçalho necessário |
Cabeçalhos opcionais |
|---|---|---|
_CrtMemDumpStatistics |
<crtdbg.h> |
<errno.h> |
Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.
Bibliotecas: Somente as versões de depuração das Recursos da biblioteca CRT.
Exemplo
Consulte crt_dbg1.