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 |