_CrtMemCheckpoint
Uzyskuje bieżący stan sterta debugowania i przechowuje je w strukturze dostarczonej _CrtMemState
przez aplikację (tylko wersja debugowania).
Składnia
void _CrtMemCheckpoint(
_CrtMemState *state
);
Parametry
state
Wskaźnik do _CrtMemState
struktury do wypełnienia punktem kontrolnym pamięci.
Uwagi
Funkcja _CrtMemCheckpoint
tworzy migawkę bieżącego stanu sterta debugowania w danym momencie. Ta migawka może być używana przez inne funkcje stanu stert, takie jak _CrtMemDifference
w celu wykrywania przecieków pamięci i innych problemów. Gdy _DEBUG
nie jest zdefiniowana, wywołania do _CrtMemState
są usuwane podczas przetwarzania wstępnego.
Aplikacja musi przekazać wskaźnik do wcześniej przydzielonego wystąpienia _CrtMemState
struktury zdefiniowanego w pliku Crtdbg.h w parametrze state
. Jeśli _CrtMemCheckpoint
wystąpi błąd podczas tworzenia punktu kontrolnego, funkcja generuje _CRT_WARN
raport debugowania opisujący problem.
Aby uzyskać więcej informacji na temat funkcji stanu sterta i _CrtMemState
struktury, zobacz Funkcje raportowania stanu stert. Aby uzyskać więcej informacji na temat przydzielania, inicjowania i zarządzania blokami pamięci w wersji debugowania sterty podstawowej, zobacz szczegóły sterty debugowania CRT.
Jeśli state
parametr ma NULL
wartość , wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonywanie jest dozwolone do kontynuowania, errno
, , _sys_errlist
_doserrno
, i jest ustawiona na EINVAL
, a _sys_nerr
funkcja zwraca.
Wymagania
Procedura | Wymagany nagłówek |
---|---|
_CrtMemCheckpoint |
<crtdbg.h>, <errno.h> |
Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.
Biblioteki: debugowanie tylko wersji narzędzia UCRT.