Fonctions de débogage d’attente

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est 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.]

Microsoft DirectShow fournit plusieurs fonctions pour le débogage des attentes infinies.

Dans les builds de vente au détail, les fonctions DbgWaitForMultipleObjects et DbgWaitForSingleObject fonctionnent comme leurs équivalents de l’API Windows, WaitForMultipleObjects et WaitForSingleObject, avec des intervalles de délai d’attente infinis.

Dans les builds de débogage, ces fonctions utilisent une valeur globale de délai d’attente. Si le délai d’expiration expire, la fonction déclenche une assertion. La clé de Registre suivante spécifie la valeur de délai d’attente, en millisecondes :

HKEY_LOCAL_MACHINE\<DebugRoot>\Nom> du< module\TIMEOUT

où <DebugRoot> est le chemin du Registre décrit dans la rubrique Fonctions de sortie de débogage.

Si la clé n’existe pas, la valeur par défaut du délai d’attente est INFINITE. Vous pouvez utiliser la fonction DbgSetWaitTimeout pour remplacer l’entrée du Registre.

Fonction	Description
DbgSetWaitTimeout	Définit la valeur de délai d’attente du débogage.
DbgWaitForMultipleObjects	Attend que tous les objets spécifiés soient signalés.
DbgWaitForSingleObject	Attend qu’un objet soit signalé.