共用方式為

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

另請參閱

結構