XAudio2 调试设施

  • 项目

XAudio2 引擎的调试版本验证参数，并提供详细的警告和错误消息。

在运行时设置调试日志记录级别

可以随时设置 XAudio2 显示的调试信息级别，方法是使用所需日志记录级别的标志填写 XAUDIO2_DEBUG_CONFIGURATION 结构，然后将该结构传递给 IXAudio2：：SetDebugConfiguration 方法。 传递给 IXAudio2：：SetDebugConfiguration 方法的值始终替代在 Windows 注册表中设置的任何默认值。

调试支持

调试工具始终可用于 Windows 8.x、Windows 10、Windows 11 中的 XAUDIO2 以及使用 XAudio2Redist 包。

对于 XAUDIO2 的旧版 DirectX SDK，在使用 XAudio2Create 创建 XAUDIO2 对象时必须使用 XAUDIO2_DEBUG_ENGINE，并且系统必须安装 DirectX SDK 开发人员运行时才能支持调试。

为 XAudio2 的 Windows (ETW) 启用事件跟踪

使用 XAudio 2.8 或更高版本时，所有调试信息都通过 ETW 记录。 若要启用这些事件的日志记录，请使用以下步骤：

  1. 在本地系统上搜索“事件查看器”并运行此应用程序。
  2. 选择菜单栏上的“视图”，并在“显示分析和调试日志”上设置检查标记。
  3. 使用树视图，选择“应用程序和服务日志/Microsoft/Windows/XAudio2”。
  4. 右键单击 Microsoft Windows XAudio2 调试日志记录 ，然后选择“属性”。
  5. 单击“启用日志”上的检查框，然后点击“确定”。 可以选择性地更改默认为 %SystemRoot%\System32\Winevt\Logs\Microsoft-Windows-XAudio2%4Debug.etl的日志位置。

正常运行方案，如果想要查看最近的活动，请打开 ETL 日志文件并查找事件。 可以使用许多工具，包括通过“打开保存的日志...”事件查看器操作窗格中的 。

有关详细信息，请参阅 事件跟踪。

调试工具

XAudio2 编程参考