_CrtSetDumpClient
Installe une fonction définie par l'application pour faire un dump des blocs de mémoire de type _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 à connecter dans le processus d'image mémoire de débogage du runtime C.
Valeur de retour
Retourne la fonction cliente de dump de bloc précédemment définie.
Notes
La fonction _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 comme _CrtMemDumpAllObjectsSince ou _CrtDumpMemoryLeaks fait un dump d'un bloc de mémoire _CLIENT_BLOCK, la fonction du dump de l'application est également appelée. _CrtSetDumpClient fournit à une application une méthode simple de détection des fuites de mémoire et de validation ou de stockage du contenu des données stockées dans des blocs _CLIENT_BLOCK. Lorsque _DEBUG n'est pas défini, Les appels de _CrtSetDumpClient sont supprimés pendant le prétraitement.
La fonction _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 userPortion est un pointeur du début de la partie des données de l'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 vers la fonction de dump cliente passé à _CrtSetDumpClient est du type _CRT_DUMP_CLIENT, comme défini dans Crtdbg.h:
typedef void (__cdecl *_CRT_DUMP_CLIENT)( void *, size_t );
Pour plus d'informations sur les fonctions qui opèrent sur les blocs de mémoire de type _CLIENT_BLOCK, consultez Fonctions de raccordement de bloc client. La fonction _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 sur la compatibilité, consultez Compatibilité dans l'introduction.
Bibliothèques
Seulement les versions debug des bibliothèques Runtime C.
Équivalent .NET Framework
Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.