_aligned_msize

Devuelve el tamaño de un bloque de memoria asignado en el montón.

Sintaxis

size_t _aligned_msize(
   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

La _aligned_msize función devuelve el tamaño, en bytes, del bloque de memoria asignado por una llamada a _aligned_malloc o _aligned_realloc. Los valores de alignment y offset deben ser iguales que los valores que se pasan a la función que asignó el bloque.

Cuando la aplicación se vincula con una versión de depuración de las bibliotecas en tiempo de ejecución de C, _aligned_msize se resuelve como _aligned_msize_dbg. Para obtener más información sobre cómo se administra el montón durante el proceso de depuración, consulte El montón de depuración de CRT.

Esta función valida su parámetro. Si memblock es un puntero nulo o alignment no es una potencia de 2, _aligned_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.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Requisitos

Routine	Encabezado necesario
_aligned_msize	<malloc.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Bibliotecas

Todas las versiones de las bibliotecas en tiempo de ejecución de C.

Consulte también

Asignación de memoria