Fonctions de création de rapports sur l'état du tas

Mise à jour : novembre 2007

Cette rubrique s'applique à :

Édition	Visual Basic	C#	C++	Web Developer
Express			Natif uniquement
Standard			Natif uniquement
Pro et Team			Natif uniquement

Légende du tableau :

	Applicable
	Non applicable
	Commande ou commandes masquées par défaut.

Plusieurs fonctions reportent le contenu du tas de débogage à un moment donné.

_CrtMemState

Pour capturer un instantané récapitulatif de l'état du tas à un moment donné, utilisez la structure _CrtMemState définie dans CRTDBG.H :

typedef struct _CrtMemState
{
    // Pointer to the most recently allocated block:
    struct _CrtMemBlockHeader * pBlockHeader;
    // A counter for each of the 5 types of block:
    size_t lCounts[_MAX_BLOCKS];
    // Total bytes allocated in each block type:
    size_t lSizes[_MAX_BLOCKS];
    // The most bytes allocated at a time up to now:
    size_t lHighWaterCount;
    // The total bytes allocated at present:
    size_t lTotalCount;
} _CrtMemState;

Cette structure enregistre un pointeur vers le premier bloc (celui qui a été alloué en dernier) dans la liste liée du tas de débogage. Elle enregistre ensuite dans deux tableaux le nombre de blocs de mémoire de chaque type (_NORMAL_BLOCK, _CLIENT_BLOCK, _FREE_BLOCK, etc.) présents dans la liste et le nombre d'octets alloués dans chaque type de bloc. Enfin, elle enregistre le plus grand nombre d'octets alloués globalement dans le tas jusqu'à ce point et le nombre d'octets actuellement alloués.

Autres fonctions de création de rapports CRT

Les fonctions suivantes reportent l'état et le contenu du tas, et utilisent les informations pour faciliter la détection des fuites de mémoire et des autres problèmes.

Fonction	Description
_CrtMemCheckpoint	Enregistre un instantané du tas dans une structure _CrtMemState fournie par l'application.
_CrtMemDifference	Compare deux structures d'état de mémoire, enregistre la différence entre ces dernières dans une troisième structure d'état et retourne TRUE si les deux états sont différents.
_CrtMemDumpStatistics	Fait un dump d'une structure _CrtMemState donnée. La structure peut contenir un instantané de l'état du tas de débogage à un moment donné ou la différence entre deux instantanés.
_CrtMemDumpAllObjectsSince	Fait un dump des informations sur tous les objets alloués depuis la capture d'un instantané donné du tas ou le début de l'exécution. Chaque fois que la fonction fait un dump d'un bloc _CLIENT_BLOCK, elle appelle une fonction de raccordement fournie par l'application, si une telle fonction a été installée à l'aide de la routine _CrtSetDumpClient.
_CrtDumpMemoryLeaks	Détermine si des fuites de mémoire se sont produites depuis le début de l'exécution du programme et, dans ce cas, fait un dump de tous les objets alloués. Chaque fois que _CrtDumpMemoryLeaks fait un dump d'un bloc _CLIENT_BLOCK, elle appelle une fonction de raccordement fournie par l'application, si une telle fonction a été installée à l'aide de la routine _CrtSetDumpClient.

Voir aussi

Autres ressources

Tas de débogage CRT