_aligned_recalloc

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Modifie la taille d’un bloc de mémoire qui a été alloué avec _aligned_malloc ou _aligned_offset_malloc et initialise la mémoire à 0.

void * _aligned_recalloc(  
   void *memblock,   
   size_t num,  
   size_t size,   
   size_t alignment  
);  

Paramètres

[in] memblock
Pointeur de bloc de mémoire actif.

[in] num
Nombre d'éléments.

[in] size
Taille en octets de chaque élément.

[in] alignment
Valeur de l'alignement, qui doit être un entier à la puissance 2.

_aligned_recalloc 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 l'argument de mémoire tampon n'est pas NULL, ou si la mémoire disponible est insuffisante 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 qui est obligatoirement aligné correctement pour le stockage de tout type d'objet. Pour obtenir un pointeur vers un type autre que void, utilisez un cast de type sur la valeur de retour.

Le fait de réallouer la mémoire et de modifier l'alignement d'un bloc constitue une erreur.

_aligned_recallocest basé sur malloc. Pour plus d’informations sur l’utilisation de _aligned_offset_malloc, consultez malloc.

Cette fonction affecte à errno la valeur ENOMEM si l'allocation de mémoire a échoué ou si la taille demandée était supérieure à _HEAP_MAXREQ. Pour plus d’informations sur errno, consultez errno, _doserrno, _sys_errlist et _sys_nerr. De plus, _aligned_recalloc valide ses paramètres. Si alignment n’est pas une puissance de 2, cette fonction appelle le Gestionnaire de paramètre non valide, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, cette fonction retourne NULL et affecte la valeur errno à EINVAL.

RoutineEn-tête requis
_aligned_recalloc<malloc.h>

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

Alignement des données
_recalloc
_aligned_offset_recalloc

Afficher: