Condividi tramite

Funzionalità di debug di XAudio2

  • Articolo

La versione di debug del motore XAudio2 convalida i parametri e fornisce messaggi di avviso e di errore dettagliati.

Impostazione del livello di registrazione di debug in fase di esecuzione

È possibile impostare il livello di informazioni di debug visualizzate da XAudio2 in qualsiasi momento compilando una struttura XAUDIO2_DEBUG_CONFIGURATION con i flag per il livello di registrazione desiderato e quindi passare la struttura al metodo IXAudio2::SetDebugConfiguration . I valori passati al metodo IXAudio2::SetDebugConfiguration sostituiscono sempre tutti i valori predefiniti impostati nel Registro di sistema di Windows.

Supporto per il debug

Le funzionalità di debug sono sempre disponibili per XAUDIO2 in Windows 8.x, Windows 10, Windows 11 e quando si usa il pacchetto XAudio2Redist.

Per le versioni legacy di DirectX SDK di XAUDIO2, è necessario usare XAUDIO2_DEBUG_ENGINE durante la creazione dell'oggetto XAUDIO2 con XAudio2Create e il sistema deve aver installato DirectX SDK Developer Runtime per supportare il debug.

Abilitazione di Event Tracing for Windows (ETW) per XAudio2

Con XAudio 2.8 o versione successiva, tutte le informazioni di debug vengono registrate tramite ETW. Per abilitare la registrazione di questi eventi, seguire questa procedura:

  1. Cercare "Visualizzatore eventi" nel sistema locale ed eseguire questa applicazione.
  2. Selezionare Visualizza sulla barra dei menu e impostare il segno di spunta in Mostra log analitici e di debug.
  3. Usando la visualizzazione struttura ad albero, selezionare Registri applicazioni e servizi/Microsoft/Windows/XAudio2.
  4. Fare clic con il pulsante destro del mouse sulla registrazione di debug di Microsoft Windows XAudio2 e scegliere "Proprietà".
  5. Fare clic sulla casella di controllo "Abilita log" e premere "OK". Facoltativamente, è possibile modificare il percorso del log che per impostazione predefinita è %SystemRoot%\System32\Winevt\Logs\Microsoft-Windows-XAudio2%4Debug.etl.

Eseguire gli scenari come di consueto e quando si vuole visualizzare l'attività recente, aprire il file di log ETL e cercare gli eventi. Sono disponibili diversi strumenti che è possibile usare, tra cui il Visualizzatore eventi tramite "Apri log salvato..." nel riquadro azioni.

Per altre informazioni, vedere Event Tracing.For more information, see Event Tracing.

Funzionalità di debug

Guida di riferimento alla programmazione di XAudio2