_CrtMemDumpStatistics

Despeja as informações de cabeçalho de depuração de um estado de heap especificado em um formato legível pelo usuário (somente versão de depuração).

Sintaxe

void _CrtMemDumpStatistics(
   const _CrtMemState *state
);

Parâmetros

state
Ponteiro para o estado de heap a ser despejado.

Comentários

A função _CrtMemDumpStatistics despeja as informações de cabeçalho de depuração para um estado especificado do heap em um formato legível pelo usuário. As estatísticas de despejo podem ser usadas pelo aplicativo para acompanhar as alocações e detectar problemas de memória. O estado de memória pode conter um estado de heap específico 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 state deve ser um ponteiro para uma estrutura _CrtMemState que tenha sido preenchida por _CrtMemCheckpoint ou retornada por _CrtMemDifference antes de _CrtMemDumpStatistics ser chamado. Se state for NULL, o manipulador de parâmetro inválido será chamado, conforme descrito em Validação de parâmetro. Se for permitido continuar a execução, errno será definido como EINVAL e nenhuma ação será tomada. Para obter mais informações, consulte errno, _doserrno, _sys_errlist e _sys_nerr.

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

Requisitos

Rotina	Cabeçalho necessário	Cabeçalhos opcionais
_CrtMemDumpStatistics	<crtdbg.h>	<errno.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Bibliotecas: depurar somente as versões das bibliotecas de runtime do C.

Confira também

Rotinas de depuração