Функция DbgLockTrace
[Функция, связанная с этой страницей 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();
Требование | Значение |
---|---|
Заголовок |
|
Библиотека |
|