_aligned_recalloc
Modifie la taille d'un bloc de mémoire qui a été allouée 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
Le pointeur de bloc mémoire actuel.[in] num
Nombre d'éléments.[in] size
La taille en octets de chaque élément du tableau.[in] alignment
La valeur d'alignement, qui doit être une puissance entière de 2.
Valeur de retour
_aligned_recalloc retourne un pointeur void sur le bloc mémoire realloué (et éventuellement déplacé). La valeur de retour est NULL si la taille est de zéro et que l'argument de mémoire tampon n'est pas NULL, ou s'il n'y a pas assez de mémoire disponible pour développer le bloc jusqu'à la taille spécifiée. Dans le premier cas, le bloc d'origine est libéré. Dans le deuxième cas, le bloc d'origine reste inchangé. Les valeur de retour pointent vers un espace de stockage, qui est garanti d'etre aligné correctement pour le stockage de n'importe quel types d'objet. Pour obtenir un pointeur sur un type autre que void, utilisez un cast de type sur la valeur de retour.
C'est une erreur de réallouer la mémoire et de modifier l'alignement d'un bloc.
Notes
_aligned_recalloc est basé sur malloc. Pour plus d'informations sur l'utilisation de _aligned_offset_malloc, consultez 6ewkz86d(v=vs.120).md.
Cette fonction alloue à errno la valeur ENOMEM si l'allocation de mémoire a échoué ou si la taille demandée est supérieure à _HEAP_MAXREQ. Pour plus d'informations sur errno, consultez errno, _doserrno, _sys_errlist et _sys_nerr. Aussi, _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 renvoie NULL et définit errno avec la valeur EINVAL.
Configuration requise
Routine |
En-tête requis |
|---|---|
_aligned_recalloc |
<malloc.h> |
Équivalent .NET Framework
Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.