структура XAUDIO2_DEBUG_CONFIGURATION (xaudio2.h)

  • Статья

Содержит новую глобальную конфигурацию отладки для XAudio2. Используется с функцией SetDebugConfiguration .

Синтаксис

typedef struct XAUDIO2_DEBUG_CONFIGURATION {
  UINT32 TraceMask;
  UINT32 BreakMask;
  BOOL   LogThreadID;
  BOOL   LogFileline;
  BOOL   LogFunctionName;
  BOOL   LogTiming;
} XAUDIO2_DEBUG_CONFIGURATION;

Члены

TraceMask

Битовая маска включенных типов сообщений отладки. Может иметь значение 0 или один или несколько из следующих:

Значение Описание
XAUDIO2_LOG_ERRORS Регистрируются сообщения об ошибках. 
XAUDIO2_LOG_WARNINGS Предупреждающие сообщения журнала.
Примечание Включение XAUDIO2_LOG_WARNINGS также позволяет XAUDIO2_LOG_ERRORS.
 
XAUDIO2_LOG_INFO Журнал информационных сообщений. 
XAUDIO2_LOG_DETAIL Регистрируются подробные информационные сообщения.
Примечание Включение XAUDIO2_LOG_DETAIL также позволяет XAUDIO2_LOG_INFO.
 
XAUDIO2_LOG_API_CALLS Записы и выходы из открытых функций API в журнале. 
XAUDIO2_LOG_FUNC_CALLS Регистрируются записи внутренних функций и выходы из нее.
Примечание Включение XAUDIO2_LOG_FUNC_CALLS также включает XAUDIO2_LOG_API_CALLS.
 
XAUDIO2_LOG_TIMING Обнаруженные задержки в журнале и другие данные о времени. 
XAUDIO2_LOG_LOCKS Использование критически важных разделов и мьютексов в журнале. 
XAUDIO2_LOG_MEMORY Сведения об использовании кучи памяти в журнале. 
XAUDIO2_LOG_STREAMING Сведения о потоковой передаче звука в журнале. 

BreakMask

Типы сообщений, вызывающие немедленное прерывание. Может иметь значение 0 или одно из следующих:

Значение Описание
XAUDIO2_LOG_ERRORS Прервать сообщения об ошибках. 
XAUDIO2_LOG_WARNINGS Прерывание в предупреждающих сообщениях.
Примечание Включение XAUDIO2_LOG_WARNINGS также позволяет XAUDIO2_LOG_ERRORS.
 

LogThreadID

Указывает, следует ли регистрировать идентификатор потока с каждым сообщением.

LogFileline

Указывает, следует ли регистрировать исходные файлы и номера строк.

LogFunctionName

Указывает, следует ли регистрировать имена функций.

LogTiming

Указывает, следует ли регистрировать метки времени сообщения.

Комментарии

Отладка сообщений может быть полностью отключена путем инициализации XAUDIO2_DEBUG_CONFIGURATION для всех нулей.

Примечание Для этой версии XAudio2 в TraceMask или BreakMask поддерживается только значение XAUDIO2_LOG_ERRORS. Все остальные элементы и значения игнорируются.
 

Требования к платформе

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); Пакет SDK Для DirectX (XAudio 2.7)

Требования

Требование Значение
Заголовок xaudio2.h

См. также раздел

Структуры