Функция DbgLockTrace

Статья
07/28/2023

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Включает или отключает ведение журнала отладки для заданного критического раздела.

Синтаксис

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

Параметры

pcCrit: Указатель на критический раздел CCritSec .
fTrace: Значение, указывающее, включено ли ведение журнала. Используйте значение TRUE , чтобы включить ведение журнала, или FALSE , чтобы отключить его.

Возвращаемое значение

Эта функция не возвращает значение.

Используйте эту функцию для трассировки определенного критического раздела. По умолчанию ведение журнала отладки критически важных разделов отключено из-за большого количества критических разделов.

Чтобы отследить критически важный раздел, выполните следующие действия.

Определите DEBUG или _DEBUG перед включением заголовков DirectShow.
Включите ведение журнала отладки для критически важных разделов, вызвав DbgSetModuleLevel с флагом LOG_LOCKING.
Вызовите 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();

Требования

Требование	Значение
Заголовок	Wxutil.h (включая Streams.h)
Библиотека	Strmbase.lib (розничные сборки); Strmbasd.lib (отладочные сборки)

См. также раздел

Функции отладки критических разделов

Поделиться через