_CrtMemCheckpoint

 

Publicado: octubre de 2016

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Obtiene el estado actual del montón de depuración y lo almacena en una estructura de _CrtMemState proporcionada por la aplicación (solo versión de depuración).

void _CrtMemCheckpoint(  
   _CrtMemState *state   
);  

Parámetros

state
Puntero a la estructura de _CrtMemState que se va a rellenar con el punto de control de memoria.

La función _CrtMemCheckpoint crea una instantánea del estado actual del montón de depuración en cualquier momento determinado. Esta instantánea la pueden usar otras funciones de estado del montón, como _CrtMemDifference , para ayudar a detectar pérdidas de memoria y otros problemas. Si no se define _DEBUG , las llamadas a _CrtMemState se quitan durante el preprocesamiento.

La aplicación debe pasar un puntero a una instancia de la estructura de _CrtMemState previamente asignada, definida en Crtdbg.h, en el parámetro state . Si _CrtMemCheckpoint encuentra un error durante la creación del punto de control, la función genera un informe de depuración de _CRT_WARN en el que se describe el problema.

Para más información sobre las funciones de estado del montón y la estructura _CrtMemState , vea Heap State Reporting Functions. Para más 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, vea CRT Debug Heap Details.

Si state es NULL, the invalid parameter handler es invoked, as described in Parameter Validation. Si la ejecución puede continuar, errno, _doserrno, _sys_errlist y _sys_nerr está establecido en EINVAL y devuelve la función.

RutinaEncabezado necesario
_CrtMemCheckpoint<crtdbg.h>, <errno.h>

Para obtener más información sobre compatibilidad, vea Compatibility en la introducción.

Bibliotecas: solo versiones de depuración de la UCRT.

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.

Rutinas de depuración
_CrtMemDifference

Mostrar: