Nástroje pro ladění XAudio2
Ladicí verze modulu XAudio2 ověřuje parametry a poskytuje podrobné upozornění a chybové zprávy.
Nastavení úrovně protokolování ladění za běhu
Úroveň informací o ladění zobrazených v XAudio2 můžete kdykoli nastavit vyplněním struktury XAUDIO2_DEBUG_CONFIGURATION s příznaky pro požadovanou protokolovací úroveň a poté tuto strukturu předat metodě IXAudio2::SetDebugConfiguration. Hodnoty předané metodě IXAudio2::SetDebugConfiguration vždy přepíší všechny výchozí hodnoty, které byly nastaveny v registru Systému Windows.
Podpora ladění
Ladicí nástroje jsou vždy k dispozici pro XAUDIO2 ve Windows 8.x, Windows 10, Windows 11 a při použití balíčku XAudio2Redist.
Pro starší verze sady DirectX SDK XAUDIO2 je nutné použít XAUDIO2_DEBUG_ENGINE při vytváření objektu XAUDIO2 s XAudio2Create a systém musí mít nainstalovaný DirectX SDK Developer Runtime, aby se ladění podporovalo.
Povolení trasování událostí pro Windows (ETW) pro XAudio2
Ve verzi XAudio 2.8 nebo novější se všechny informace o ladění protokolují přes ETW. Protokolování těchto událostí povolíte pomocí následujících kroků:
- Vyhledejte "Prohlížeč událostí" v místním systému a spusťte tuto aplikaci.
- Na panelu nabídek vyberte Zobrazit a zaškrtněte políčko u Zobrazit analytické a ladicí protokoly.
- Ve stromovém zobrazení vyberte Protokoly aplikací a služeb / Microsoft / Windows / XAudio2.
- Klikněte pravým tlačítkem na protokolování ladění XAudio2 systému Microsoft Windows a vyberte Vlastnosti.
- Zaškrtněte políčko "Povolit protokol" a stiskněte tlačítko OK. Volitelně můžete změnit umístění protokolu, které je ve výchozím nastavení
%SystemRoot%\System32\Winevt\Logs\Microsoft-Windows-XAudio2%4Debug.etl.
Spusťte scénáře jako normální a když chcete zobrazit nedávnou aktivitu, otevřete soubor protokolu ETL a vyhledejte události. Existuje řada nástrojů, které můžete použít, včetně prohlížeče událostí prostřednictvím příkazu Otevřít uložený protokol... v podokně akcí.
Další informace naleznete v tématu trasování událostí.
Související témata