_CrtSetDumpClient
Instala uma função definida pelo aplicativo para despejo _CLIENT_BLOCK Digite blocos de memória (somente versão de depurar).
_CRT_DUMP_CLIENT _CrtSetDumpClient(
_CRT_DUMP_CLIENT dumpClient
);
Parâmetros
- dumpClient
Nova função de despejo de memória definida pelo cliente para capturar ao C em time de execução depurar o processo de despejo de memória.
Valor de retorno
Retorna o bloco de cliente definidas anteriormente despejar a função.
Comentários
The _CrtSetDumpClient função permite que o aplicativo capturar a sua própria função para despejo de objetos armazenados no _CLIENT_BLOCK blocos de memória para o C em time de execução depurar o processo de despejo de memória. sistema autônomo resultado, sempre que uma depurar despejar função, sistema autônomo _CrtMemDumpAllObjectsSince or _CrtDumpMemoryLeaks dumps a _CLIENT_BLOCK Bloco de memória despejo função do aplicativo é chamada também. _CrtSetDumpClient Fornece um aplicativo com um método fácil para detecção de vazamentos de memória e validar ou reportar o Sumário dos dados armazenados em _CLIENT_BLOCK blocos. Quando _DEBUG não estiver definido, chamadas de _CrtSetDumpClient serão removidos durante a pré-processamento.
The _CrtSetDumpClient função instala a nova função definida pelo aplicativo despejo especificada no dumpClient e retorna a função de despejo previamente definidos. Um exemplo de uma função de despejo de bloco do cliente é sistema autônomo segue:
void DumpClientFunction( void *userPortion, size_t blockSize );
The userPortion argumento é um ponteiro para o início da parte de dados de usuário do bloco de memória e blockSize Especifica o dimensionar do bloco de memória alocada em bytes. A função de despejo de bloco do cliente deve retornar void. O ponteiro para a função de despejo de cliente que é passado para _CrtSetDumpClient é do tipo _CRT_DUMP_CLIENT, conforme definido no Crtdbg.h:
typedef void (__cdecl *_CRT_DUMP_CLIENT)( void *, size_t );
Para obter um exemplo de como implementar uma função definida pelo aplicativo despejo, consulte Exemplo do crt_dbg2: C em tempo de execução depuração gancho funções.Para obter mais informações sobre funções que operam em _CLIENT_BLOCK Digite blocos de memória, consulte Funções do cliente bloco gancho.The _CrtReportBlockType função pode ser usada para retornar informações sobre tipos de bloco e subtipos.
Requisitos
Rotina |
Cabeçalho necessário |
---|---|
_CrtSetDumpClient |
<crtdbg.h> |
Para obter mais informações de compatibilidade, consulte Compatibilidade na introdução.
Bibliotecas
Versões de depurar de Bibliotecas de time de execução c somente.
Exemplo
Para obter um exemplo de como usar _CrtSetDumpClient, consulte crt_dbg2.
Equivalente do NET Framework
Não aplicável. Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.