Função DbgLockTrace

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Habilita ou desabilita o log de depuração de uma determinada seção crítica.

Sintaxe

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

Parâmetros

pcCrit

Ponteiro para uma seção crítica do CCritSec .

fTrace

Valor que especifica se o registro em log está habilitado. Use TRUE para habilitar o registro em log ou FALSE para desabilitá-lo.

Retornar valor

Essa função não retorna um valor.

Comentários

Use essa função para rastrear uma seção crítica específica. Por padrão, o log de depuração de seções críticas está desabilitado devido ao grande número de seções críticas.

Para rastrear uma seção crítica, execute as seguintes etapas:

1. Defina DEBUG ou _DEBUG antes de incluir os cabeçalhos do DirectShow.
2. Habilite o log de depuração para seções críticas chamando DbgSetModuleLevel com o sinalizador LOG_LOCKING.
3. Chame DbgLockTrace na seção crítica que você deseja rastrear.

Em builds de varejo, a função DbgLockTrace não tem efeito.

Exemplos

O exemplo de código a seguir mostra como rastrear uma seção 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

Confira também

Funções críticas de depuração de seção