_CrtMemCheckpoint
Obtiene el estado actual del montón de depuración y lo almacena en una estructura aplicación-proporcionada de _CrtMemState (versión de depuración solo).
void _CrtMemCheckpoint(
_CrtMemState *state
);
Parámetros
- state
puntero a la estructura de _CrtMemState a rellenar con el punto de comprobación de memoria.
Comentarios
La función de _CrtMemCheckpoint crea una instantánea del estado actual del montón de depuración en cualquier momento determinado.Esta instantánea se puede utilizar en otras funciones de estado del montón como _CrtMemCheckpoint para ayudar a detectar pérdidas de memoria y otros problemas.Cuando _DEBUG no está definido, las llamadas a _CrtMemState se quitan durante el preprocesamiento.
La aplicación debe pasar un puntero a una instancia previamente asignada de la estructura de _CrtMemState , definido en Crtdbg.h, en el parámetro de state .Si _CrtMemCheckpoint encuentra un error durante la creación de punto de comprobación, la función genera un informe de depuración de _CRT_WARN que describe el problema.
Para obtener más información sobre las funciones de estado de la pila y la estructura de _CrtMemState , vea Funciones que indican el estado del montón.Para obtener más 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 La administración de memoria y el montón de depuración.
Si state es NULL, se 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, errno, _doserrno, _sys_errlist, y _sys_nerr se establece en EINVAL y finaliza la función.
Requisitos
rutina |
Encabezado necesario |
|---|---|
_CrtMemCheckpoint |
<crtdbg.h> , <errno.h> |
Para obtener más información de compatibilidad, vea Compatibilidad en la Introducción.
bibliotecas: Versiones de depuración de Características de la biblioteca CRT únicamente.
Ejemplo
Vea crt_dbg1.
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 Ejemplos de invocación de plataforma.