DbgLockTrace 函式

[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

啟用或停用指定重要區段的偵錯記錄。

語法

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

參數

pcCrit

CCritSec critical 區段的指標。

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();

規格需求

需求	值
標頭	Wxutil.h (包含 Streams.h)
程式庫	Strmbase.lib (零售組建) ; Strmbasd.lib (偵錯組建)

另請參閱

重要區段偵錯函式