Partager via


_free_dbg

Libère un bloc de mémoire dans le tas (version Debug uniquement).

void _free_dbg( 
   void *userData,
   int blockType 
);

Paramètres

  • userData
    Pointeur du bloc de mémoire alloué à libérer.

  • blockType
    Type de bloc de mémoire alloué à libérer : _CLIENT_BLOCK, _NORMAL_BLOCK, ou _IGNORE_BLOCK.

Notes

La fonction _free_dbg est une version Debug de la fonction _free. Lorsque _DEBUG n'est pas défini, chaque appel à _free_dbg est réduit à un appel à free. free et _free_dbg libèrent un bloc de mémoire dans le tas de base, mais _free_dbg s'adapte aux deux fonctionnalités de débogage : la capacité à conserver les blocs dans la liste liée du tas pour simuler des conditions de mémoire insuffisante et un paramètre de type de bloc pour libérer l'allocation spécifique types.

_free_dbg exécute un contrôle de validité sur tous les fichiers spécifiés et tous les emplacements de bloc avant d'exécuter l'opération libre. L'application n'est pas destinée à fournir ces informations. Lorsque un bloc de mémoire est libéré, le gestionnaire de tas de débogage vérifie automatiquement l'intégrité des mémoires tampons de chaque côté de la partie de l'utilisateur et envoie un rapport d'erreur si un remplacement a eu lieu. Si le champ de bits _CRTDBG_DELAY_FREE_MEM_DF de l'indicateur _crtDbgFlag est défini, le bloc libéré est rempli avec la valeur 0xDD, assigné _FREE_BLOCK de bloc, et conservé dans la liste liée du tas de blocs de mémoire.

Si une erreur se produit en libérant la mémoire, errno est défini avec les informations du système d'exploitation sur la nature de l'échec. Pour plus d'informations, consultez errno, _doserrno, _sys_errlist et _sys_nerr.

Pour obtenir des informations sur la façon dont les blocs de mémoire sont alloués, initialisés, et gérés dans la version Debug du tas de base, consultez Détails du tas de débogage CRT. Pour obtenir des informations sur les types de bloc d'allocation et leur utilisation, consultez Types de blocs sur le tas de débogage. Pour obtenir des informations sur les différences entre appeler une fonction standard du tas et sa version Debug dans une version debug d'une application, consultez Versions Debug des fonctions d'allocation du tas.

Configuration requise

Routine

En-tête requis

_free_dbg

<crtdbg.h>

Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.

Exemple

Pour un exemple d'utilisation de _free_dbg, consultez crt_dbg2.

Équivalent .NET Framework

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.

Voir aussi

Référence

Routines de débogage

_malloc_dbg