_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
Tamaño de la asignación de memoria solicitada.[in] alignment
Valor de la alineación, que debe ser un entero potencia 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 alinearse convenientemente 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 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, 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, la función devuelve NULL y establece errno en EINVAL.
Requisitos
Rutina |
Encabezado necesario |
|---|---|
_aligned_realloc |
<malloc.h> |
Ejemplo
Para obtener más información, vea _aligned_malloc.