_CrtMemDumpAllObjectsSince
Vide les informations sur les objets dans le tas à partir du début de l’exécution du programme ou d’un état de tas spécifié (version de débogage uniquement).
Syntaxe
void _CrtMemDumpAllObjectsSince(
const _CrtMemState *state
);
Paramètres
state
Pointeur vers l’état du tas pour commencer le dumping à partir ou NULL
.
Notes
La fonction _CrtMemDumpAllObjectsSince
vide les informations d’en-tête de débogage des objets alloués dans le tas sous une forme lisible par l’utilisateur. Les informations de vidage permettent à l’application d’effectuer le suivi des allocations et de détecter les problèmes de mémoire. Quand _DEBUG
n’est pas défini, les appels à _CrtMemDumpAllObjectsSince
sont supprimés lors du prétraitement.
_CrtMemDumpAllObjectsSince
utilise la valeur du paramètre state
pour déterminer où lancer l’opération de vidage. Pour commencer le vidage à partir d’un état de tas spécifié, le state
paramètre doit être un pointeur vers une _CrtMemState
structure qui a été renseignée avant _CrtMemCheckpoint
_CrtMemDumpAllObjectsSince
d’être appelée. Quand state
c’est NULL
le cas, la fonction commence le vidage à partir du début de l’exécution du programme.
Si l’application a installé une fonction de hook de vidage en appelant _CrtSetDumpClient
, chaque fois que _CrtMemDumpAllObjectsSince
les informations sont vidées sur un _CLIENT_BLOCK
type de bloc, elle appelle également la fonction de vidage fournie par l’application. Par défaut, les blocs d’exécution C internes (_CRT_BLOCK
) ne sont pas inclus dans les opérations de vidage de mémoire. La _CrtSetDbgFlag
fonction peut être utilisée pour activer le _CRTDBG_CHECK_CRT_DF
bit de _crtDbgFlag
ces blocs. En outre, les blocs marqués comme libérés ou ignorés (_FREE_BLOCK
, _IGNORE_BLOCK
) ne sont pas inclus dans le vidage de mémoire.
Pour plus d’informations sur les fonctions d’état du tas et sur la structure _CrtMemState
, consultez Fonctions de création de rapports sur l’état du tas. Pour plus d’informations sur la façon dont les blocs de mémoire sont alloués, initialisés et gérés dans la version de débogage du tas de base, consultez Détails du tas de débogage CRT.
Spécifications
Routine | En-tête requis |
---|---|
_CrtMemDumpAll-ObjectsSince | <crtdbg.h> |
Pour plus d’informations sur la compatibilité, consultez Compatibility.
Bibliothèques
Uniquement les versions de débogage des bibliothèques Runtime C.
Exemple
Pour obtenir un exemple d’utilisation _CrtMemDumpAllObjectsSince
, consultez crt_dbg2
.