_aligned_realloc
Cambia el tamaño de un bloque de memoria asignado con _aligned_malloc o _aligned_offset_malloc.
Sintaxis
void * _aligned_realloc(
void *memblock,
size_t size,
size_t alignment
);
Parámetros
memblock
Puntero de bloque de memoria actual.
size
Tamaño de la asignación de memoria solicitada.
alignment
Valor de la alineación, que debe ser un entero potencia de 2.
Valor devuelto
_aligned_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 a void, use una conversión de tipo en el valor devuelto.
Se trata de un error para reasignar la memoria y cambiar la alineación de un bloque.
Comentarios
_aligned_realloc se basa en malloc. Para obtener más información acerca de cómo usar _aligned_offset_malloc, vea 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_realloc valida sus parámetros. Si alignment no es una potencia de 2, 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_realloc |
<malloc.h> |
Ejemplo
Para obtener más información, vea _aligned_malloc.