_CrtSetDumpClient
Installe une fonction définie par l’application pour vider des blocs de mémoire de type _CLIENT_BLOCK
(version de débogage uniquement).
Syntaxe
_CRT_DUMP_CLIENT _CrtSetDumpClient( _CRT_DUMP_CLIENT dumpClient );
Paramètres
dumpClient
Nouvelle fonction de vidage de mémoire définie par le client à raccorder.
Valeur retournée
Retourne la fonction de vidage de bloc définie par le client.
Notes
La _CrtSetDumpClient
fonction permet à l’application de raccorder sa propre fonction pour vider des objets stockés dans des _CLIENT_BLOCK
blocs de mémoire. Par conséquent, chaque fois qu’une fonction de vidage de débogage, telle que _CrtMemDumpAllObjectsSince
ou _CrtDumpMemoryLeaks
vidage d’un _CLIENT_BLOCK
bloc de mémoire, la fonction de vidage de l’application est également appelée. _CrtSetDumpClient
fournit à une application une méthode simple pour détecter les fuites de mémoire et pour valider le contenu des données stockées dans des blocs _CLIENT_BLOCK
ou pour créer des rapports à partir de ce contenu. Quand _DEBUG
n’est pas défini, les appels à _CrtSetDumpClient
sont supprimés lors du prétraitement.
La fonction _CrtSetDumpClient
installe la nouvelle fonction de vidage définie par l’application spécifiée dans dumpClient
et retourne la fonction de vidage définie. Voici un exemple de fonction de vidage de bloc client :
void DumpClientFunction( void *userPortion, size_t blockSize );
L’argument userPortion
est un pointeur désignant le début de la partie des données utilisateur du bloc de mémoire et blockSize
spécifie la taille du bloc de mémoire alloué en octets. La fonction de vidage de bloc client doit retourner void
. Le pointeur désignant la fonction de vidage client 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 fonctionnent sur _CLIENT_BLOCK
des blocs de mémoire de type, consultez fonctions de raccordement de bloc client. La _CrtReportBlockType
fonction peut être utilisée pour retourner des informations sur les types de blocs et les sous-types.
Spécifications
Routine | En-tête requis |
---|---|
_CrtSetDumpClient |
<crtdbg.h> |
Pour plus d’informations sur la compatibilité, consultez Compatibility.
Bibliothèques
Uniquement les versions de débogage des bibliothèques Runtime C.