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 或一或多個：
| 值 | Description |
|---|---|
| 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 | 重要區段和 Mutex 的記錄使用量。 |
| XAUDIO2_LOG_MEMORY | 記錄記憶體堆積使用量資訊。 |
| XAUDIO2_LOG_STREAMING | 記錄音訊串流資訊。 |
BreakMask
會導致立即中斷的訊息類型。 可以是 0 或下列其中一項：
| 值 | Description |
|---|---|
| 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) ;DirectX SDK (XAudio 2.7)規格需求
| 需求 | 值 |
|---|---|
| 標頭 | xaudio2.h |