_aligned_realloc
Cambia el tamaño de un bloque de memoria que fue asignado con _aligned_malloc o _aligned_offset_malloc.
void * _aligned_realloc(
void *memblock,
size_t size,
size_t alignment
);
Parámetros
[in] memblock
El puntero actual del bloque de memoria.[in] size
El tamaño de asignación de memoria solicitada.[in] alignment
El valor alignment, que debe ser una potencia entero de 2.
Valor devuelto
_aligned_realloc devuelve un puntero void (y posiblemente desplazado) al bloque de memoria reasignado.El valor devuelto es NULL si el tamaño es cero y el argumento del búfer no es NULL, 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 de original no varía.Los puntos del valor devuelto a un espacio de almacenamiento que se garantiza que sea sencilla alineadas para el almacenamiento de cualquier tipo de objeto.Para obtener un puntero a un tipo distinto de vacío, utilice una conversión de tipo del valor devuelto.
Es un error para reasignar la memoria y para cambiar la alineación de un bloque.
Comentarios
_aligned_realloc se basa en malloc.Para obtener más información sobre cómo utilizar _aligned_offset_malloc, vea malloc.
Esta función establece errno a ENOMEM aunque falle la asignación de memoria o si el tamaño solicitado era mayor que _HEAP_MAXREQ.Para obtener más información sobre errno, vea 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 el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, esta función devuelve NULL y establece errno a EINVAL.
Requisitos
rutina |
Encabezado necesario |
|---|---|
_aligned_realloc |
<malloc.h> |
Ejemplo
Para obtener más información, vea _aligned_malloc.