XAudio2 偵錯設施

XAudio2 引擎的偵錯版本會驗證參數，並提供詳細的警告和錯誤訊息。

在執行時間設定偵錯記錄層級

您可以隨時使用所需記錄層級的旗標填入 XAUDIO2_DEBUG_CONFIGURATION 結構，然後將結構傳遞至 IXAudio2：：SetDebugConfiguration 方法，以設定 XAudio2 所顯示的偵錯資訊層級。傳遞至 IXAudio2：：SetDebugConfiguration 方法的值一律會覆寫 Windows 登錄中設定的任何預設值。

偵錯功能一律適用于 Windows 8.x、Windows 10、Windows 11，以及使用XAudio2Redist 套件的 XAUDIO2。

針對舊版的 XAUDIO2，您必須在建立XAudio2物件時使用XAUDIO2_DEBUG_ENGINE，而且系統必須安裝 DirectX SDK 開發人員執行時間，才能支援偵錯。

透過 XAudio 2.8 或更新版本，所有偵錯資訊都會透過 ETW 記錄。若要啟用這些事件的記錄，請使用下列步驟：

在您的本機系統上搜尋「事件檢視器」，然後執行此應用程式。
選取功能表列上的 [檢視]，然後在 [顯示分析和偵錯記錄] 上設定核取記號。
使用樹狀檢視，選取 [應用程式和服務記錄]/[Microsoft/Windows/ XAudio2]。
以滑鼠右鍵按一下 Microsoft Windows XAudio2 偵錯記錄 ，然後選取 [屬性]。
按一下 [啟用記錄] 上的核取方塊，然後按一下 [確定]。您可以選擇性地變更預設為 %SystemRoot%\System32\Winevt\Logs\Microsoft-Windows-XAudio2%4Debug.etl 的記錄位置。

如常執行您的案例，以及當您想要查看最近的活動時，請開啟 ETL 記錄檔並尋找事件。您可以使用許多工具，包括透過「開啟已儲存的記錄...」事件檢視器在動作窗格中。

如需詳細資訊，請參閱事件追蹤。