Función DbgLockTrace
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
Habilita o deshabilita el registro de depuración de una sección crítica determinada.
Sintaxis
void WINAPI DbgLockTrace(
CCritSec *pcCrit,
BOOL fTrace
);
Parámetros
-
pcCrit
-
Puntero a una sección crítica de CCritSec .
-
fTrace
-
Valor que especifica si el registro está habilitado. Use TRUE para habilitar el registro o FALSE para deshabilitarlo.
Valor devuelto
Esta función no devuelve ningún valor.
Observaciones
Use esta función para realizar un seguimiento de una sección crítica específica. De forma predeterminada, el registro de depuración de secciones críticas está deshabilitado, debido al gran número de secciones críticas.
Para realizar un seguimiento de una sección crítica, realice los pasos siguientes:
- Defina DEBUG o _DEBUG antes de incluir los encabezados directShow.
- Habilite el registro de depuración para secciones críticas mediante una llamada a DbgSetModuleLevel con la marca LOG_LOCKING.
- Llame a DbgLockTrace en la sección crítica que desea realizar un seguimiento.
En las compilaciones comerciales, la función DbgLockTrace no tiene ningún efecto.
Ejemplos
En el ejemplo de código siguiente se muestra cómo realizar un seguimiento de una sección crítica.
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();
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|