Share via


_CrtMemCheckpoint

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.

Comentarios

La función _CrtMemCheckpoint crea una instantánea del estado actual del montón de depuración en cualquier momento determinado. Esta instantánea se puede usar en otras funciones de estado del montón, como _CrtMemDifference, para ayudar a detectar pérdidas de memoria y otros problemas. Cuando _DEBUG no se define, 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 obtener más información sobre las funciones de estado del montón y la estructura de _CrtMemState, vea Funciones que indican el estado del montón. Para obtener 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 Detalles del montón de depuración de CRT.

Si state es NULL, se invoca el controlador de parámetros no válidos, 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 la función devuelve un valor.

Requisitos

Rutina

Encabezado necesario

_CrtMemCheckpoint

<crtdbg.h>, <errno.h>

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

Bibliotecas: solo versiones de depuración de Características de la biblioteca CRT.

Ejemplo

Consulta crt_dbg1.

Equivalente en .NET Framework

No es aplicable. Para llamar a la función estándar de C, use PInvoke. Para obtener más información, consulta Ejemplos de invocación de plataforma.

Vea también

Referencia

Rutinas de depuración

_CrtMemDifference