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, IMFMediaEngineet audio/vidéo capture dans 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 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 d’attentes infinies.

Dans les builds de vente au détail, les fonctions DbgWaitForMultipleObjects et DbgWaitForSingleObject fonctionnent comme leurs équivalents d’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 de délai d’attente globale. 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ù <> DéboguerRoot est le chemin d’accès au Registre décrit dans la rubrique Fonctions de sortie de débogage.

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