Share via


_aligned_recalloc

Cambia el tamaño de un bloque de memoria que fue asignado con _aligned_malloc o _aligned_offset_malloc e inicializa memoria a 0.

void * _aligned_recalloc(
   void *memblock, 
   size_t num,
   size_t size, 
   size_t alignment
);

Parámetros

  • [in] memblock
    El puntero actual del bloque de memoria.

  • [in] num
    El número de elementos.

  • [in] size
    Tamaño en bytes de cada elemento.

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

Valor devuelto

_aligned_recalloc 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 caso, 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_recalloc 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_recalloc 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_recalloc

<malloc.h>

Equivalente en .NET Framework

No es aplicable Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.

Vea también

Referencia

Alineación de datos

_recalloc

_aligned_offset_recalloc