_aligned_malloc_dbg
Asigna memoria en un límite de alineación especificado con el espacio adicional para un encabezado de depuración y sobrescribe los búferes (versión de depuración solo).
void * _aligned_malloc_dbg(
size_t size,
size_t alignment,
const char *filename,
int linenumber
);
Parámetros
[in] size
Tamaño de asignación de memoria solicitada.[in] alignment
El valor alignment, que debe ser una potencia entero de 2.[in] filename
Puntero al nombre del archivo de código fuente que solicitó la operación de asignación o el valor NULL.[in] linenumber
Número de línea en el archivo de código fuente donde la operación de asignación se solicitó o NULL.
Valor devuelto
Un puntero al bloque de memoria que fue asignado o a NULL si se produjo un error en la operación.
Comentarios
_aligned_malloc_dbg es una versión de depuración de la función de _aligned_malloc .Cuando _DEBUG no está definido, cada llamada a _aligned_malloc_dbg se reduce a una llamada a _aligned_malloc._aligned_malloc y _aligned_malloc_dbg asignan un bloque de memoria del montón base, pero _aligned_malloc_dbg proporciona varias características de depuración: búferes situados a cada lado de la parte del usuario del bloque para comprobar pérdidas, y filename/información delinenumber para determinar el origen de las solicitudes de asignación.
_aligned_malloc_dbg asigna el bloque de memoria con ligeramente más espacio que sizesolicitado.El espacio adicional usa el administrador del montón de depuración para vincular los bloques de memoria de depuración y proporcionar la aplicación con la información de encabezado de depuración y sobrescribir los búferes.Cuando se asigna el bloque, rellenan a la parte del usuario de bloque con el valor 0xCD y cada uno de los búferes sobrescribirán se rellena con 0xFD.
_aligned_malloc_dbg establece errno a ENOMEM si se produce una asignación de memoria o si la cantidad de memoria necesaria (sobrecarga incluidos mencionada previamente) supera _HEAP_MAXREQ.Para obtener información sobre estos y otros códigos de error, vea errno, _doserrno, _sys_errlist, y _sys_nerr.Además, _aligned_malloc_dbg valida sus parámetros.Si alignment no es una potencia de 2 o size es cero, 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.
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 bloquee los tipos y cómo se utilizan, vea Tipos de bloques del montón de depuración.
Requisitos
rutina |
Encabezado necesario |
|---|---|
_aligned_malloc_dbg |
<crtdbg.h> |
Para obtener más información de compatibilidad, vea compatibilidad en la Introducción.
bibliotecas
Versiones de depuración de Bibliotecas en tiempo de ejecución de C únicamente.
Equivalente en .NET Framework
No es aplicable Para llamar a la función estándar de C, utilice PInvoke. Para obtener más información, vea La invocación de plataforma ejemplos.