DbgLockTrace-Funktion

Aktiviert oder deaktiviert die Debugprotokollierung eines bestimmten kritischen Abschnitts.

Syntax

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

Parameter

pcCrit

Zeiger auf einen kritischen CCritSec-Abschnitt.

fTrace

Wert, der angibt, ob die Protokollierung aktiviert ist. Verwenden Sie TRUE, um die Protokollierung zu aktivieren, oder FALSE, um sie zu deaktivieren.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Hinweise

Verwenden Sie diese Funktion, um einen bestimmten kritischen Abschnitt nachzuverfolgen. Standardmäßig ist die Debugprotokollierung kritischer Abschnitte aufgrund der großen Anzahl kritischer Abschnitte deaktiviert.

Führen Sie die folgenden Schritte aus, um einen kritischen Abschnitt nachzuverfolgen:

  1. Definieren Sie DEBUG oder _ DEBUG, bevor Sie die DirectShow-Header einschließen.
  2. Aktivieren Sie die Debugprotokollierung für kritische Abschnitte, indem Sie DbgSetModuleLevel mit dem LOG _ LOCKING-Flag aufrufen.
  3. Rufen Sie DbgLockTrace für den kritischen Abschnitt auf, den Sie nachverfolgen möchten.

In Einzelhandelsbuilds hat die DbgLockTrace-Funktion keine Auswirkungen.

Beispiele

Das folgende Codebeispiel zeigt, wie ein kritischer Abschnitt nachverfolgt wird.

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

Anforderungen

Anforderung Wert
Header
Wxutil.h (include Streams.h)
Bibliothek
Strmbase.lib (Verkaufsbuilds);
Strmbasd.lib (Debugbuilds)

Weitere Informationen

Debugfunktionen im kritischen Abschnitt