_aligned_offset_realloc

Cambia el tamaño de un bloque de memoria asignado con _aligned_malloc o _aligned_offset_malloc.

Sintaxis

void * _aligned_offset_realloc(
   void *memblock,
   size_t size,
   size_t alignment,
   size_t offset
);

Parámetros

memblock
Puntero de bloque de memoria actual.

size
Tamaño de la asignación de memoria.

alignment
Valor de la alineación, que debe ser un entero potencia de 2.

offset
Desplazamiento en la asignación de memoria para imponer la alineación.

Valor devuelto

_aligned_offset_realloc devuelve un puntero void al bloque de memoria reasignado (y, probablemente, trasladado). El valor devuelto es NULL si el tamaño es cero y el argumento de búfer no NULLes , o si no hay suficiente memoria disponible para expandir el bloque al tamaño especificado. En el primer caso, se libera el bloque original. En el segundo, el bloque original permanece inalterado. El valor devuelto apunta a un espacio de almacenamiento correctamente alineado para almacenar cualquier tipo de objeto. Para obtener un puntero a un tipo distinto de void, use una conversión de tipo en el valor devuelto.

_aligned_offset_realloc está marcado __declspec(noalias) como y __declspec(restrict), lo que significa que se garantiza que la función no modifique las variables globales y que el puntero devuelto no tenga alias. Para obtener más información, vea noalias y restrict.

Comentarios

Al igual _aligned_offset_mallocque , _aligned_offset_realloc permite que una estructura se alinee en un desplazamiento dentro de la estructura.

_aligned_offset_realloc se basa en malloc. Para obtener más información acerca de cómo usar _aligned_offset_malloc, vea malloc. Si memblock es NULL, la función llama internamente a _aligned_offset_malloc.

Esta función establece errno en ENOMEM si se produce un error en la asignación de memoria o si el tamaño solicitado es mayor que _HEAP_MAXREQ. Para obtener más información sobre errno, consulte errno, _doserrno, _sys_errlist y _sys_nerr. Además, _aligned_offset_realloc valida sus parámetros. Si alignment no es una potencia de 2 o si offset no es cero y mayor o igual que size, esta función invoca al controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, la función devuelve NULL y establece errno en EINVAL.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Requisitos

Routine	Encabezado necesario
_aligned_offset_realloc	<malloc.h>

Ejemplo

Para obtener más información, vea _aligned_malloc.

Consulte también

Alineación de datos