DbgLockTrace 함수

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

지정된 중요 섹션의 디버그 로깅을 사용하거나 사용하지 않도록 설정합니다.

구문

void WINAPI DbgLockTrace(
   CCritSec *pcCrit,
   BOOL     fTrace
);

매개 변수

pcCrit

CCritSec 중요 섹션에 대한 포인터입니다.

fTrace

로깅을 사용할지 여부를 지정하는 값입니다. TRUE를 사용하여 로깅을 사용하도록 설정하거나 FALSE를 사용하여 사용하지 않도록 설정합니다.

반환 값

이 함수는 값을 반환하지 않습니다.

설명

이 함수를 사용하여 특정 중요 섹션을 추적합니다. 기본적으로 중요한 섹션이 많기 때문에 중요한 섹션의 디버그 로깅을 사용할 수 없습니다.

중요한 섹션을 추적하려면 다음 단계를 수행합니다.

1. DirectShow 헤더를 포함하기 전에 DEBUG 또는 _DEBUG 정의합니다.
2. LOG_LOCKING 플래그를 사용하여 DbgSetModuleLevel 을 호출하여 중요한 섹션에 대한 디버그 로깅을 사용하도록 설정합니다.
3. 추적하려는 중요한 섹션에서 DbgLockTrace 를 호출합니다.

소매 빌드에서는 DbgLockTrace 함수가 적용되지 않습니다.

예제

다음 코드 예제에서는 중요 섹션을 추적하는 방법을 보여줍니다.

DbgInitialise(g_hInst);
DbgSetModuleLevel(LOG_LOCKING, 3);

{
    CCritSec MyLock;
    DbgLockTrace(&MyLock, TRUE);
    
    CAutoLock cObjectLock(&MyLock);

    // Protected section of code.    
    DbgOutString("This code is inside a critical section.\n");

} // Lock goes out of scope here.

DbgTerminate();

요구 사항

추가 정보

중요 섹션 디버깅 함수