_aligned_realloc

 

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

Modifie la taille d'un bloc de mémoire qui a été allouée avec _aligned_malloc ou _aligned_offset_malloc.

void * _aligned_realloc(  
   void *memblock,   
   size_t size,   
   size_t alignment  
);  

Paramètres

[in] memblock
Le pointeur de bloc mémoire actuel.

[in] size
La taille de l'allocation de mémoire demandée.

[in] alignment
La valeur d'alignement, qui doit être une puissance entière de 2.

_aligned_realloc 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, le bloc d'origine reste inchangé. Les valeur de retour pointent vers un espace de stockage, qui est garanti d'être 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.

_aligned_realloc est basée sur malloc. Pour plus d'informations sur l'utilisation de _aligned_offset_malloc, consultez https://msdn.microsoft.com/fr-fr/library/6ewkz86d.aspx.

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_realloc 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.

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

Pour plus d'informations, consultez aligned_malloc.

Alignement des données

Afficher: