_aligned_offset_realloc
Modifie la taille d'un bloc de mémoire alloué avec _aligned_malloc ou _aligned_offset_malloc.
void * _aligned_offset_realloc(
void *memblock,
size_t size,
size_t alignment,
size_t offset
);
Paramètres
memblock
le pointeur actuel de bloc de mémoire.size
la taille de l'allocation de mémoire.alignment
La valeur d'inscription, qui doit être une puissance entière à 2.offset
l'offset dans l'allocation de mémoire pour forcer l'alignement.
Valeur de retour
_aligned_offset_realloc retourne un pointeur void (et éventuellement déplacé) au bloc de mémoire réaffecté.La valeur de retour est NULL si la taille est zéro et l'argument de mémoire tampon n'est pas NULL, ou s'il n'y a pas assez de mémoire libre pour développer le bloc à la taille donnée.dans le premier cas, le bloc d'origine est libéré.Dans le deuxième cas, le bloc d'origine reste inchangé.Les points de valeur de retour à un espace de stockage qui est obligatoirement aligné pour le stockage d'un type d'objet.Pour obtenir un pointeur vers un type autre que le type void, utilisez un cast de type sur la valeur de retour.
_aligned_offset_realloc est __declspec(noalias) marqué et __declspec(restrict), ce qui signifie que la fonction est garantie ne pas modifier les variables globales et que le pointeur retourné pas alias.Pour plus d'informations, consultez noalias et le restreignez.
Notes
comme _aligned_offset_malloc, _aligned_offset_realloc permet une structure à aligner à un offset dans la structure.
_aligned_offset_realloc est basé sur malloc.Pour plus d'informations sur l'utilisation _aligned_offset_malloc, consultez malloc.si memblock est NULL, les appels de fonction _aligned_offset_malloc en interne.
Cette fonction définit errno à 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.en outre, _aligned_offset_realloc valide ses paramètres.Si alignment n'est pas une puissance de 2 ou si offset est supérieure ou égale à size et une valeur différente de zéro, cette fonction appelle le gestionnaire de paramètre non valide, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution de se poursuivre, retourne NULL de cette fonction et définit errno à EINVAL.
Configuration requise
routine |
en-tête requis |
|---|---|
_aligned_offset_realloc |
<malloc.h> |
Exemple
Pour plus d'informations, consultez _aligned_malloc.