Share via

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

指示是否使用每条消息记录线程 ID。

LogFileline

指示是否记录源文件和行号。

LogFunctionName

指示是否记录函数名称。

LogTiming

指示是否记录消息时间戳。

注解

通过将 XAUDIO2_DEBUG_CONFIGURATION 初始化为所有零，可以完全关闭调试消息。

注意对于此版本的 XAudio2，TraceMask 或 BreakMask 仅支持 XAUDIO2_LOG_ERRORS 值。 将忽略所有其他成员和值。
 

平台要求

Windows 10 (XAudio2.9) ;Windows 8，Windows Phone 8 (XAudio 2.8) ;DirectX SDK (XAudio 2.7)

要求

要求 值
Header xaudio2.h

另请参阅

结构