_CrtSetDumpClient
Installe une fonction définie par l'application pour faire un dump des blocs de mémoire de type d' _CLIENT_BLOCK (version debug uniquement).
_CRT_DUMP_CLIENT _CrtSetDumpClient(
_CRT_DUMP_CLIENT dumpClient
);
Paramètres
- dumpClient
Nouvelle fonction définie par le client d'image mémoire à raccorder dans le processus d'image mémoire de débogage du runtime C.
Valeur de retour
Retourne la fonction cliente définie précédemment de dump de bloc.
Notes
La fonction d' _CrtSetDumpClient permet à l'application de raccorder sa propre fonction pour faire un dump des objets stockés dans les blocs de mémoire de _CLIENT_BLOCK dans le processus d'image mémoire de débogage du runtime C.En conséquence, chaque fois qu'une fonction de vidage du débogage telles que _CrtMemDumpAllObjectsSince ou _CrtDumpMemoryLeaks fait un dump d'un bloc de mémoire de _CLIENT_BLOCK , la fonction du dump de l'application est également appelée._CrtSetDumpClient fournit à une demande une méthode simple de détection des fuites de mémoire et de valider ou d'enregistrer le contenu des données stockées dans des blocs d' _CLIENT_BLOCK .Lorsque _DEBUG n'est pas défini, les appels à _CrtSetDumpClient sont supprimés pendant le prétraitement.
La fonction d' _CrtSetDumpClient installe la nouvelle fonction définie par l'application de dump spécifiée dans dumpClient et retourne la fonction définie précédemment de dump.Un exemple d'une fonction cliente de dump de bloc est la suivante :
void DumpClientFunction( void *userPortion, size_t blockSize );
L'argument d' userPortion est un pointeur vers le début de la partie données utilisateur du bloc de mémoire et blockSize spécifie la taille du bloc de mémoire allouée en octets.La fonction cliente de dump de bloc doit retourner void.le pointeur à la fonction cliente de dump qui est passée à _CrtSetDumpClient est de type _CRT_DUMP_CLIENT, comme défini dans Crtdbg.h :
typedef void (__cdecl *_CRT_DUMP_CLIENT)( void *, size_t );
Pour obtenir un exemple d'implémentation d'une fonction définie par l'application de dump, consultez l' exemple crt_dbg2 : Runtime C les fonctions de raccordement du débogage.Pour plus d'informations sur les fonctions qui opèrent sur les blocs de mémoire de type d' _CLIENT_BLOCK , consultez Fonctions de raccordement de bloc.La fonction de _CrtReportBlockType peut être utilisée pour retourner des informations sur les types et des sous-types de bloc.
Configuration requise
routine |
en-tête requis |
|---|---|
_CrtSetDumpClient |
<crtdbg.h> |
Pour plus d'informations de compatibilité, consultez compatibilité dans l'introduction.
bibliothèques
Versions debug de Bibliothèques runtime C uniquement.
Exemple
Pour un exemple d'utilisation _CrtSetDumpClient, consultez crt_dbg2.
Équivalent .NET Framework
Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez l' exemples d'appel de code non managé.