_CrtSetDbgFlag

_crtDbgFlag 플래그의 상태를 검색 또는 수정하여 디버그 힙 관리자의 할당 동작을 제어합니다(디버그 버전에만 해당).

int _CrtSetDbgFlag(     int newFlag  );

매개 변수

• newFlag
  _crtDbgFlag의 새로운 상태입니다.

반환 값

_crtDbgFlag의 이전 상태를 반환합니다.

설명

_CrtSetDbgFlag 함수는 응용 프로그램에서 디버그 힙 관리자가 _crtDbgFlag 플래그의 비트 필드를 수정하여 메모리 할당을 추적하는 방법을 제어하도록 허용합니다. 응용 프로그램에서는 비트를 설정하여(켜기) 디버그 힙 관리자에 특수 디버깅 작업을 수행하도록 지시합니다. 이러한 작업에는 응용 프로그램 종료 시 메모리 누수 확인 후 메모리 누수가 발견되면 보고, 힙의 연결된 목록에 확보한 메모리 블록이 남아 있도록 지정하여 메모리 부족 조건을 시뮬레이션 및 모든 할당 요청 시 각 메모리 블록을 조사하여 힙의 무결성을 확인하는 작업 등이 있습니다. _DEBUG가 정의되지 않은 경우 전처리 중 _CrtSetDbgFlag에 대한 호출이 제거됩니다.

다음 테이블은 _crtDbgFlag의 비트 필드를 보여주고 이러한 필드의 동작에 대해 설명합니다. 비트를 설정하면 진단 출력이 늘어나고 프로그램 실행 속도가 줄어들기 때문에 비트는 기본적으로 설정되지 않습니다(꺼짐). 기존 비트 필드에 대한 자세한 내용은 힙 상태 보고 함수를 참조하세요.

힙 검사 빈도 매크로

malloc, realloc, free 및 _msize 호출 횟수를 기반으로 C 런타임 라이브러리가 디버그 힙(_CrtCheckMemory)에 대한 유효성 검사를 수행하는 빈도를 지정할 수 있습니다.

그런 다음 _CrtSetDbgFlag 함수는 값의 newFlag 매개 변수에 대해 상위 16비트를 검사합니다. 지정된 값은 _CrtCheckMemory 호출 사이의 malloc, realloc, free 및 _msize 호출 횟수입니다. 이러한 용도로 미리 정의된 매크로 4개가 제공됩니다.

기본적으로 _CrtCheckMemory는 malloc, realloc, free 및 _msize를 1,024번 호출할 때마다 한 번 호출합니다.

예를 들어 다음 코드를 사용하여 malloc, realloc, free 및 _msize 작업을 16회 수행할 때마다 힙 검사를 실행하도록 지정할 수 있습니다.

#include <crtdbg.h>
int main( )
{
int tmp;

// Get the current bits
tmp = _CrtSetDbgFlag(_CRTDBG_REPORT_FLAG);

// Clear the upper 16 bits and OR in the desired freqency
tmp = (tmp & 0x0000FFFF) | _CRTDBG_CHECK_EVERY_16_DF;

// Set the new bits
_CrtSetDbgFlag(tmp);
}

_CRTDBG_CHECK_ALWAYS_DF가 지정되면 newFlag 매개 변수의 상위 16비트가 무시됩니다. 이 경우 malloc, realloc, free 및 _msize를 호출할 때마다 _CrtCheckMemory가 호출됩니다.

newFlag는 _crtDbgFlag에 지정되는 새 상태이고 각 비트 필드에 대한 값의 조합입니다.

이러한 비트 필드를 하나 이상 변경하고 플래그에 새로운 상태를 만들려면

1. 현재 _crtDbgFlag 상태를 가져오기 위해 newFlag를 사용하여 _CrtSetDbgFlag를 _CRTDBG_REPORT_FLAG와 동일하게 호출하고 반환된 값을 임시 변수에 저장합니다.

2. 해당 비트 마스크(응용 프로그램 코드에 명시적 상수로 표시)로 임시 변수를 OR 연산하여 모든 비트를 설정합니다.

3. 적절한 비트 마스크의 비트 NOT 연산자를 사용하여 변수를 AND 연산하여 다른 비트를 설정 해제합니다.

4. newFlag를 사용하여 임시 변수에 저장된 값과 동일하게 _CrtSetDbgFlag를 호출하여 _crtDbgFlag에 대해 새 상태를 설정합니다.

다음 코드는 확보한 메모리 블록을 힙의 연결된 목록에 유지하여 메모리 부족 조건을 시뮬레이션하는 방법과 할당 요청 시마다 _CrtCheckMemory가 호출되지 않도록 방지하는 방법을 보여줍니다.

// Get the current state of the flag
// and store it in a temporary variable
int tmpFlag = _CrtSetDbgFlag( _CRTDBG_REPORT_FLAG );

// Turn On (OR) - Keep freed memory blocks in the
// heap's linked list and mark them as freed
tmpFlag |= _CRTDBG_DELAY_FREE_MEM_DF;

// Turn Off (AND) - prevent _CrtCheckMemory from
// being called at every allocation request
tmpFlag &= ~_CRTDBG_CHECK_ALWAYS_DF;

// Set the new state for the flag
_CrtSetDbgFlag( tmpFlag );

메모리 관리 및 디버그 힙의 개요는 CRT 디버그 힙 정보를 참조하세요.

_CrtSetDbgFlag 함수를 사용하여 플래그를 사용하지 않도록 설정하려면 비트 마스크의 비트 NOT 연산자를 사용하여 변수를 AND 연산해야 합니다.

newFlag가 유효한 값이 아니면 이 함수는 매개 변수 유효성 검사에서 설명된 대로 잘못된 매개 변수 처리기를 호출합니다. 계속해서 실행하도록 허용한 경우 함수는 errno를 EINVAL로 설정하고 _crtDbgFlag의 이전 상태를 반환합니다.

요구 사항

호환성에 대한 자세한 내용은 소개 단원의 호환성 부분을 참조하십시오.

라이브러리

디버그 버전의 유일한 C 런타임 라이브러리입니다.

예제

// crt_crtsetdflag.c
// compile with: /c -D_DEBUG /MTd -Od -Zi -W3 /link -verbose:lib /debug
/*
 * This program concentrates on allocating and freeing memory
 * blocks to test the functionality of the _crtDbgFlag flag..
 */

#include <string.h>
#include <malloc.h>
#include <crtdbg.h>

int main( )
{
        char *p1, *p2;
        int tmpDbgFlag;

        _CrtSetReportMode( _CRT_ERROR, _CRTDBG_MODE_FILE );
        _CrtSetReportFile( _CRT_ERROR, _CRTDBG_FILE_STDERR );
        /*
         * Set the debug-heap flag to keep freed blocks in the
         * heap's linked list - This will allow us to catch any
         * inadvertent use of freed memory
         */
        tmpDbgFlag = _CrtSetDbgFlag(_CRTDBG_REPORT_FLAG);
        tmpDbgFlag |= _CRTDBG_DELAY_FREE_MEM_DF;
        tmpDbgFlag |= _CRTDBG_LEAK_CHECK_DF;
        _CrtSetDbgFlag(tmpDbgFlag);

        /*
         * Allocate 2 memory blocks and store a string in each
         */
        p1 = malloc( 34 );
        p2 = malloc( 38 );
        strcpy_s( p1, 34, "p1 points to a Normal allocation block" );
        strcpy_s( p2, 38, "p2 points to a Client allocation block" );

        /*
         * Free both memory blocks
         */
        free( p2 );
        free( p1 );

        /*
         * Set the debug-heap flag to no longer keep freed blocks in the
         * heap's linked list and turn on Debug type allocations (CLIENT)
         */
        tmpDbgFlag = _CrtSetDbgFlag(_CRTDBG_REPORT_FLAG);
        tmpDbgFlag |= _CRTDBG_ALLOC_MEM_DF;
        tmpDbgFlag &= ~_CRTDBG_DELAY_FREE_MEM_DF;
        _CrtSetDbgFlag(tmpDbgFlag);

        /*
         * Explicitly call _malloc_dbg to obtain the filename and 
         * line number of our allocation request and also so we can 
         * allocate CLIENT type blocks specifically for tracking
         */
        p1 = _malloc_dbg( 40, _NORMAL_BLOCK, __FILE__, __LINE__ );
        p2 = _malloc_dbg( 40, _CLIENT_BLOCK, __FILE__, __LINE__ );
        strcpy_s( p1, 40, "p1 points to a Normal allocation block" );
        strcpy_s( p2, 40, "p2 points to a Client allocation block" );

        /*
         * _free_dbg must be called to free the CLIENT block
         */
        _free_dbg( p2, _CLIENT_BLOCK );
        free( p1 );

        /*
         * Allocate p1 again and then exit - this will leave unfreed
         * memory on the heap
         */
        p1 = malloc( 10 );
}

해당 .NET Framework 항목

해당 사항 없음. 표준 C 함수를 호출하려면 PInvoke를 사용합니다. 자세한 내용은 플랫폼 호출 예제를 참조하십시오.

참고 항목

참조

디버그 루틴

_crtDbgFlag

_CrtCheckMemory