Funzione DbgLockTrace
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Abilita o disabilita la registrazione di debug di una determinata sezione critica.
Sintassi
void WINAPI DbgLockTrace(
CCritSec *pcCrit,
BOOL fTrace
);
Parametri
-
pcCrit
-
Puntatore a una sezione critica CCritSec .
-
fTrace
-
Valore che specifica se la registrazione è abilitata. Usare TRUE per abilitare la registrazione o FALSE per disabilitarla.
Valore restituito
Questa funzione non restituisce un valore.
Commenti
Usare questa funzione per tracciare una sezione critica specifica. Per impostazione predefinita, la registrazione di debug delle sezioni critiche è disabilitata, a causa del numero elevato di sezioni critiche.
Per tracciare una sezione critica, seguire questa procedura:
- Definire DEBUG o _DEBUG prima di includere le intestazioni DirectShow.
- Abilitare la registrazione di debug per le sezioni critiche chiamando DbgSetModuleLevel con il flag di LOG_LOCKING.
- Chiamare DbgLockTrace nella sezione critica da tracciare.
Nelle build al dettaglio la funzione DbgLockTrace non ha alcun effetto.
Esempio
Nell'esempio di codice seguente viene illustrato come tracciare una sezione critica.
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();
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|