_aligned_recalloc_dbg

Modifie la taille d’un bloc de mémoire qui a été alloué avec _aligned_malloc ou _aligned_offset_malloc initialise la mémoire sur 0 (version de débogage uniquement).

Syntaxe

void * _aligned_recalloc_dbg(
   void * memblock,
   size_t num,
   size_t size,
   size_t alignment,
   const char *filename,
   int linenumber
);

Paramètres

memblock
Pointeur de bloc de mémoire actif.

number
Nombre d'éléments.

size
Taille en octets de chaque élément.

alignment
Valeur d'alignement, qui doit être un entier à puissance 2.

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.

Valeur retournée

_aligned_recalloc_dbg retourne un pointeur void vers le bloc de mémoire réalloué (et éventuellement déplacé). La valeur de retour est NULL si la taille est égale à zéro et que l’argument de mémoire tampon n’est pas NULL, ou s’il n’y a pas suffisamment de mémoire disponible pour étendre le bloc à la taille donnée. Dans le premier cas, le bloc d'origine est libéré. Dans le second cas, le bloc d'origine est inchangé. La valeur de retour pointe vers un espace de stockage adapté au stockage de n’importe quel type d’objet. Pour obtenir un pointeur vers un autre type que void, utilisez un cast de type sur la valeur de retour.

Il s’agit d’une erreur pour réallouer la mémoire et modifier l’alignement d’un bloc.

Notes

_aligned_recalloc_dbg est une version de débogage de la _aligned_recalloc fonction. Lorsqu’il _DEBUG n’est pas défini, chaque appel à est _aligned_recalloc_dbg réduit à un appel à _aligned_recalloc. Les deux _aligned_recalloc et _aligned_recalloc_dbg réallouer un bloc de mémoire dans le tas de base, mais _aligned_recalloc_dbg prennent en charge plusieurs fonctionnalités de débogage : les mémoires tampons situées sur l’un ou l’autre côté du bloc pour tester les fuites et filename/linenumber les informations permettant de déterminer l’origine des demandes d’allocation. Le suivi des types d’allocation spécifiques avec un paramètre de type de bloc n’est pas une fonctionnalité de débogage prise en charge pour les allocations alignées. Les allocations alignées s’affichent en tant que _NORMAL_BLOCK type de bloc.

_aligned_recalloc_dbg réalloue le bloc de mémoire spécifié avec un peu plus d’espace que la taille demandée (number * 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 fournir à l’application des informations d’en-tête de débogage et remplacer les mémoires tampons. La réaffectation peut déplacer le bloc de mémoire d’origine vers un autre emplacement dans le tas et modifier la taille du bloc de mémoire. La partie utilisateur du bloc est remplie avec la valeur 0xCD, et les mémoires tampons de remplacement sont remplies de 0xFD.

_aligned_recalloc_dbg affecte à errno la valeur ENOMEM si une allocation de mémoire échoue ; la valeur EINVAL est retourné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 et d’autres codes d’erreur, consultez , , _sys_errlist_doserrnoet _sys_nerr.errno

De plus, _aligned_recalloc_dbg valide ses paramètres. Si alignment ce n’est pas une puissance de 2, cette fonction appelle le gestionnaire de paramètres non valide, comme décrit dans la validation des paramètres. Si l'exécution est autorisée à se poursuivre, cette fonction retourne NULL et affecte la valeur errno à EINVAL.

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 les détails du tas de débogage CRT. Pour plus d’informations sur les types de blocs d’allocation et leur utilisation, consultez Types de blocs sur le tas de débogage. Pour plus d’informations sur les différences entre les fonctions de tas standard et leurs versions de débogage, consultez Les versions de débogage des fonctions d’allocation de tas.

Spécifications

Routine	En-tête requis
_aligned_recalloc_dbg	<crtdbg.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Bibliothèques

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

Voir aussi

Routines de débogage