XAudio2 引擎的偵錯版本會驗證參數,並提供詳細的警告和錯誤訊息。
在運行時間設定偵錯記錄層級
您可以隨時透過填寫帶有所需日誌層級標記的 XAUDIO2_DEBUG_CONFIGURATION 結構來設定 XAudio2 顯示的偵錯資訊層級,然後將該結構傳遞至 IXAudio2::SetDebugConfiguration 方法。 傳遞至 IXAudio2::SetDebugConfiguration 方法的值一律會覆寫 Windows 登錄中設定的任何預設值。
偵錯支援
偵錯功能一律適用於 Windows 8.x、Windows 10、Windows 11 和 XAudio2Redist 套件中的XAUDIO2。
針對舊版 DirectX SDK XAUDIO2,您必須在建立具有 XAudio2Create 的 XAUDIO2 物件時使用 XAUDIO2_DEBUG_ENGINE,而且系統必須安裝 DirectX SDK 開發人員運行時間才能支援偵錯。
為 XAudio2 啟用 Windows 事件追蹤功能(ETW)
透過 XAudio 2.8 或更新版本,所有偵錯資訊都會透過 ETW 記錄。 若要啟用這些事件的記錄,請使用下列步驟:
- 在您的本機系統上搜尋「事件查看器」,然後執行此應用程式。
- 選取功能表列上的 [檢視],然後勾選「顯示分析和偵錯記錄」的方塊。
- 使用樹檢視,選取 [應用程式和服務記錄]/[Microsoft/Windows/XAudio2]。
- 以滑鼠右鍵按兩下 Microsoft Windows XAudio2 偵錯記錄,然後選取 [屬性]。
- 按兩下 [啟用記錄] 上的複選框,然後按兩下 [確定]。 您可以選擇性地變更預設為
%SystemRoot%\System32\Winevt\Logs\Microsoft-Windows-XAudio2%4Debug.etl的記錄位置。
正常運行您的場景,當您想要查看最新活動時,請開啟 ETL 記錄檔並查看事件。 您可以使用許多工具,其中包括在 [動作] 窗格中透過 事件查看器中的「開啟已儲存的記錄...」。
如需詳細資訊,請參閱 事件追蹤。
相關主題