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