Partager via

Fonctionnalités de débogage XAudio2

  • Article

La version de débogage du moteur XAudio2 valide les paramètres et fournit des messages d’avertissement et d’erreur détaillés.

Définition du niveau de journalisation du débogage au moment de l’exécution

Vous pouvez définir le niveau d’informations de débogage affiché par XAudio2 à tout moment en remplissant une structure de XAUDIO2_DEBUG_CONFIGURATION avec les indicateurs du niveau de journalisation souhaité, puis en transmettant la structure à la méthode IXAudio2::SetDebugConfiguration . Les valeurs transmises à la méthode IXAudio2::SetDebugConfiguration remplacent toujours toutes les valeurs par défaut définies dans le Registre Windows.

Prise en charge du débogage

Les fonctionnalités de débogage sont toujours disponibles pour XAUDIO2 dans Windows 8.x, Windows 10, Windows 11 et lors de l’utilisation du package XAudio2Redist.

Pour les versions héritées du Kit de développement logiciel (SDK) DirectX de XAUDIO2, vous devez utiliser XAUDIO2_DEBUG_ENGINE lors de la création de l’objet XAUDIO2 avec XAudio2Create et le runtime du développeur du KIT de développement logiciel (SDK) DirectX doit être installé pour que le débogage soit pris en charge.

Activation du suivi d’événements pour Windows (ETW) pour XAudio2

Avec XAudio 2.8 ou version ultérieure, toutes les informations de débogage sont enregistrées via ETW. Pour activer la journalisation de ces événements, procédez comme suit :

  1. Recherchez « observateur d'événements » sur votre système local et exécutez cette application.
  2. Sélectionnez Affichage dans la barre de menus, puis définissez la marque case activée sur Afficher les journaux analytiques et de débogage.
  3. À l’aide de l’arborescence, sélectionnez Journaux des applications et services / Microsoft / Windows / XAudio2.
  4. Cliquez avec le bouton droit sur la journalisation du débogage Microsoft Windows XAudio2 et sélectionnez « Propriétés ».
  5. Cliquez sur la zone de case activée sur « Activer le journal », puis appuyez sur « OK ». Vous pouvez éventuellement modifier l’emplacement du journal, qui est défini par défaut sur %SystemRoot%\System32\Winevt\Logs\Microsoft-Windows-XAudio2%4Debug.etl.

Exécutez vos scénarios normalement et lorsque vous souhaitez voir l’activité récente, ouvrez le fichier journal ETL et recherchez les événements. Il existe un certain nombre d’outils que vous pouvez utiliser, notamment les observateur d'événements via « Ouvrir le journal enregistré... » dans le volet Actions.

Pour plus d’informations, consultez Suivi d’événements.

Fonctionnalités de débogage

Référence de programmation XAudio2