Поделиться через

Средства отладки XAudio2

  • Статья

Отладочная версия подсистемы XAudio2 проверяет параметры и предоставляет подробные предупреждения и сообщения об ошибках.

Установка уровня ведения журнала отладки во время выполнения

Уровень отладочной информации, отображаемой XAudio2, можно задать в любое время, заполнив XAUDIO2_DEBUG_CONFIGURATION структуру флагами для требуемого уровня ведения журнала, а затем передав структуру в метод IXAudio2::SetDebugConfiguration . Значения, передаваемые методу IXAudio2::SetDebugConfiguration , всегда переопределяют все значения по умолчанию, заданные в реестре Windows.

Поддержка отладки

Средства отладки всегда доступны для XAUDIO2 в Windows 8.x, Windows 10, Windows 11 и при использовании пакета XAudio2Redist.

Для устаревших версий пакета SDK DirectX для XAUDIO2 необходимо использовать XAUDIO2_DEBUG_ENGINE при создании объекта XAUDIO2 с помощью XAudio2Create , а для поддержки отладки в системе должна быть установлена среда выполнения разработчика пакета SDK DirectX.

Включение трассировки событий Windows (ETW) для XAudio2

В XAudio 2.8 или более поздней версии все сведения об отладке регистрируются с помощью трассировки событий Windows. Чтобы включить ведение журнала этих событий, выполните следующие действия.

  1. Найдите "Просмотр событий" в локальной системе и запустите это приложение.
  2. Выберите Вид в строке меню и установите метку проверка в разделе Показать журналы аналитики и отладки.
  3. В представлении в виде дерева выберите Журналы приложений и служб / Microsoft / Windows / XAudio2.
  4. Щелкните правой кнопкой мыши ведение журнала отладки Microsoft Windows XAudio2 и выберите "Свойства".
  5. Щелкните проверка поле "Включить журнал" и нажмите кнопку "ОК". При необходимости можно изменить расположение журнала, которое по умолчанию — %SystemRoot%\System32\Winevt\Logs\Microsoft-Windows-XAudio2%4Debug.etl.

Запустите сценарии в обычном режиме, и если вы хотите просмотреть последние действия, откройте файл журнала ETL и найдите события. Существует ряд средств, которые можно использовать, в том числе Просмотр событий с помощью команды "Открыть сохраненный журнал..." в области действий.

Дополнительные сведения см. в разделе Трассировка событий.

Средства отладки

Справочник по программированию в XAudio2