_CrtMemDumpAllObjectsSince
Despeja informações sobre objetos no heap a partir do início da execução do programa ou de um estado de heap especificado (somente versão de depuração).
Sintaxe
void _CrtMemDumpAllObjectsSince(
const _CrtMemState *state
);
Parâmetros
state
Ponteiro para o estado de heap para iniciar o despejo de ou NULL.
Comentários
A função _CrtMemDumpAllObjectsSince despeja as informações de cabeçalho de depuração de objetos alocados no heap em um formato legível pelo usuário. As informações de despejo podem ser usadas pelo aplicativo para acompanhar as alocações e detectar problemas de memória. Quando _DEBUG não está definido, as chamadas para _CrtMemDumpAllObjectsSince são removidas durante o pré-processamento.
_CrtMemDumpAllObjectsSince usa o valor do parâmetro state para determinar em que ponto a operação de despejo será iniciada. Para iniciar o despejo de um estado de heap especificado, o state parâmetro deve ser um ponteiro para uma _CrtMemState estrutura que foi preenchida antes _CrtMemCheckpoint _CrtMemDumpAllObjectsSince de ser chamada. Quando state é NULL, a função inicia o despejo desde o início da execução do programa.
Se o aplicativo tiver instalado uma função de gancho de despejo chamando _CrtSetDumpClient, toda vez _CrtMemDumpAllObjectsSince que despejar informações sobre um _CLIENT_BLOCK tipo de bloco, ele também chamará a função de despejo fornecida pelo aplicativo. Por padrão, os blocos internos do runtime do C (_CRT_BLOCK) não são incluídos em operações de despejo de memória. A _CrtSetDbgFlag função pode ser usada para ativar o _CRTDBG_CHECK_CRT_DF bit de _crtDbgFlag para incluir esses blocos. Além disso, os blocos marcados como liberados ou ignorados (_FREE_BLOCK, _IGNORE_BLOCK) não são incluídos no despejo de memória.
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 |
|---|---|
| _CrtMemDumpAll-ObjectsSince | <crtdbg.h> |
Para obter informações sobre compatibilidade, consulte Compatibilidade.
Bibliotecas
Somente versões de depuração de bibliotecas de tempo de execução C.
Exemplo
Para encontrar um exemplo de como usar _CrtMemDumpAllObjectsSince, confira crt_dbg2.