DbgLockTrace, fonction
[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
Active ou désactive la journalisation du débogage d’une section critique donnée.
Syntaxe
void WINAPI DbgLockTrace(
CCritSec *pcCrit,
BOOL fTrace
);
Paramètres
-
pcCrit
-
Pointeur vers une section critique CCritSec .
-
fTrace
-
Valeur spécifiant si la journalisation est activée. Utilisez TRUE pour activer la journalisation ou FALSE pour la désactiver.
Valeur renvoyée
Cette fonction ne retourne pas de valeur.
Notes
Utilisez cette fonction pour suivre une section critique spécifique. Par défaut, la journalisation du débogage des sections critiques est désactivée en raison du grand nombre de sections critiques.
Pour suivre une section critique, procédez comme suit :
- Définissez DEBUG ou _DEBUG avant d’inclure les en-têtes DirectShow.
- Activez la journalisation du débogage pour les sections critiques, en appelant DbgSetModuleLevel avec l’indicateur LOG_LOCKING.
- Appelez DbgLockTrace sur la section critique que vous souhaitez suivre.
Dans les builds commerciales, la fonction DbgLockTrace n’a aucun effet.
Exemples
L’exemple de code suivant montre comment tracer une section critique.
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();
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|