Exportar (0) Imprimir
Expandir todo
and
div
eof
not
or
xor
Expandir Minimizar
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

_aligned_realloc_dbg

Cambia el tamaño de un bloque de memoria que fue asignado con _aligned_malloc o _aligned_offset_malloc (versión de depuración solo).

void * _aligned_realloc_dbg(
   void *memblock, 
   size_t size, 
   size_t alignment,
   const char *filename,
   int linenumber 
);

[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.

[in] filename

Puntero al nombre del archivo de código fuente que solicitó la operación realloc o valor NULL.

[in] linenumber

Número de línea del archivo de código fuente en la que se solicitó la operación realloc o valor NULL.

_aligned_realloc_dbg 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.

_aligned_realloc_dbg es una versión de depuración de la función _aligned_realloc. Cuando _DEBUG no está definido, cada llamada a _aligned_realloc_dbg se reduce a una llamada a _aligned_realloc. _aligned_realloc y _aligned_realloc_dbg reasignan un bloque de memoria del montón base, pero _aligned_realloc_dbg incluye varias características de depuración: búferes situados a cada lado de la parte del usuario del bloque para comprobar que escape, un parámetro blocktype para realizar tipos específicos de asignación, y filename/información delinenumber determinan el origen de las solicitudes de asignación.

_aligned_realloc_dbg reasigna el bloque de memoria especificado con un poco más de espacio que el newSize solicitado. newSize podría ser mayor o menor que el tamaño del bloque de memoria asignado originalmente. El administrador del montón de depuración usa el espacio adicional para vincular los bloques de memoria de depuración, y para proporcionar a la aplicación información de encabezado de depuración y sobrescribir los búferes. La reasignación podría hacer que el bloque de memoria original se ponga en una ubicación distinta del montón y cambiar el tamaño del bloque de memoria. Si se mueve el bloque de memoria, el contenido del bloque original se sobrescribe.

_aligned_realloc_dbg establece errno en ENOMEM si se produce un error de asignación de memoria o si la cantidad de memoria necesaria (incluida la sobrecarga ya mencionada) es mayor que _HEAP_MAXREQ. Para obtener más información sobre este y otros códigos de error, vea errno, _doserrno, _sys_errlist y _sys_nerr.

Además, _aligned_realloc_dbg 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.

Para obtener información sobre cómo los bloques de memoria se asignan, inicialice, y se administran en la versión de depuración del montón base, vea Administración de memoria y el montón de depuración. Para obtener información sobre la asignación de tipos de bloque y cómo se usan, vea Tipos de bloques en el montón de depuración. Para obtener información sobre las diferencias entre llamar a una función estándar de la pila y la versión de depuración en una compilación de depuración de una aplicación, vea Con la versión Versus de depuración la versión base.

Rutina

Encabezado necesario

_aligned_realloc_dbg

<crtdbg.h>

Para obtener más información de compatibilidad, vea Compatibilidad en la Introducción.

Bibliotecas

Solo las versiones de depuración de las bibliotecas en tiempo de ejecución de C.

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.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft