Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
and
div
eof
not
or
xor
Développer Réduire
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

_recalloc_dbg

Réalloue un tableau et initialise ses éléments à 0 (version de débogage uniquement).

void *_recalloc_dbg(     void *userData,    size_t num,    size_t size,    int blockType,    const char *filename,    int linenumber  );

userData

Pointeur vers le bloc de mémoire précédemment alloué.

num

Nombre de blocs de mémoire demandé.

size

Taille de chaque bloc de mémoire demandée (octets).

blockType

Type de bloc de mémoire demandé : _CLIENT_BLOCK ou _NORMAL_BLOCK.

Pour plus d'informations sur les types de blocs d'allocation et sur leur utilisation, voir Types de bloc sur le tas de débogage.

filename

Pointeur vers le nom du fichier source qui a demandé l'opération d'allocation ou NULL.

linenumber

Numéro de ligne dans le fichier source où l'opération d'allocation a été demandée ou NULL.

Les paramètres filename et linenumber sont disponibles uniquement quand la fonction _recalloc_dbg a été appelée explicitement ou quand la constante de préprocesseur _CRTDBG_MAP_ALLOC a été définie.

Une fois exécutée, cette fonction retourne un pointeur vers la partie utilisateur du bloc de mémoire réalloué, appelle la nouvelle fonction de gestionnaire ou retourne NULL. Pour obtenir une description complète du comportement de retour, voir la section Notes. Pour plus d'informations sur l'utilisation de la nouvelle fonction de gestionnaire, voir la fonction _recalloc.

_recalloc_dbg est une version de débogage de la fonction _recalloc. Quand _DEBUG n'est pas défini, chaque appel à _recalloc_dbg est réduit à un appel à _recalloc. _recalloc et _recalloc_dbg réallouent toutes deux un bloc de mémoire dans le tas de base, mais _recalloc_dbg gère plusieurs fonctionnalités de débogage : des mémoires tampons de chaque côté de la partie utilisateur du bloc pour vérifier la présence de fuites, un paramètre de type de bloc pour effectuer le suivi de types d'allocation spécifiques et des informations filename/linenumber pour déterminer l'origine des demandes d'allocation.

_recalloc_dbg réalloue le bloc de mémoire spécifié avec un peu plus d'espace que la taille demandée (num * size), ce qui peut donner une taille inférieure ou supérieure à la taille du bloc de mémoire alloué initialement. L'espace supplémentaire est utilisé par le gestionnaire de tas de débogage pour lier les blocs de mémoire de débogage et pour fournir à l'application des informations sur les en-têtes de débogage et les mémoires tampons de remplacement. La réallocation peut entraîner un déplacement du bloc de mémoire initial vers un autre emplacement dans le tas, ainsi qu'une modification de la taille du bloc de mémoire. La partie utilisateur du bloc contient la valeur 0xCD et chaque mémoire tampon de remplacement contient 0xFD.

_recalloc_dbg affecte à errno la valeur ENOMEM si une allocation de mémoire échoue ; la valeur EINVAL est renvoyée si la quantité de mémoire nécessaire (y compris la surcharge mentionnée précédemment) dépasse _HEAP_MAXREQ. Pour plus d'informations sur ce code d'erreur et d'autres, voir errno, _doserrno, _sys_errlist et _sys_nerr.

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, voir Détails du tas de débogage CRT. Pour plus d'informations sur les différences entre l'appel à une fonction de tas standard et sa version de débogage dans une build de débogage d'une application, voir Versions Debug des fonctions d'allocation du tas.

Routine

En-tête requis

_recalloc_dbg

<crtdbg.h>

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

Bibliothèques

Uniquement les versions de débogage des bibliothèques Runtime C.

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

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft