_aligned_msize_dbg
Devuelve el tamaño de un bloque de memoria asignado en el montón (solo versión de depuración).
Sintaxis
size_t _aligned_msize_dbg(
void *memblock,
size_t alignment,
size_t offset
);
Parámetros
memblock
Puntero al bloque de memoria.
alignment
Valor de la alineación, que debe ser un entero potencia de 2.
offset
Desplazamiento en la asignación de memoria para imponer la alineación.
Valor devuelto
Devuelve el tamaño (en bytes) de un entero sin signo.
Comentarios
Los valores de alignment
y offset
deben ser iguales que los valores que se pasan a la función que asignó el bloque.
_aligned_msize_dbg
es una versión de depuración de la _aligned_msize
función. Cuando _DEBUG
no se define, cada llamada a se reduce a _aligned_msize_dbg
una llamada a _aligned_msize
. _aligned_msize
y _aligned_msize_dbg
calculan el tamaño de un bloque de memoria del montón base, pero _aligned_msize_dbg
agrega una característica de depuración: incluye los búferes situados en cada extremo de la parte del usuario del bloque de memoria en el tamaño que devuelve.
Esta función valida su parámetro. Si memblock
es un puntero nulo o alignment
no es una potencia de 2, _msize
invoca un controlador de parámetros no válido, como se describe en Validación de parámetros. Si se controla el error, la función establece errno
en EINVAL
y devuelve -1.
Para obtener información sobre cómo se asignan, inicializan y administran los bloques de memoria en la versión de depuración del montón base, consulte Detalles del montón de depuración de CRT. Para obtener información sobre los tipos de bloques de asignación y cómo se usan, consulte Tipos de bloques en el montón de depuración. Para obtener información sobre las diferencias entre las funciones de montón estándar y sus versiones de depuración, consulte Depuración de versiones de funciones de asignación de montón.
Requisitos
Routine | Encabezado necesario |
---|---|
_aligned_msize_dbg |
<crtdbg.h> |
Para obtener más información sobre compatibilidad, consulte Compatibilidad.
Bibliotecas
Solo versiones de depuración de las bibliotecas en tiempo de ejecución de C.