Ferramentas de depuração do XAudio2

A versão de depuração do mecanismo XAudio2 valida parâmetros e fornece avisos detalhados e mensagens de erro.

Definindo o nível de log de depuração em tempo de execução

Você pode definir o nível de informações de depuração mostrado pelo XAudio2 a qualquer momento, preenchendo uma estrutura do tipo XAUDIO2_DEBUG_CONFIGURATION com os sinalizadores para o nível de log desejado e, em seguida, passar essa estrutura para o método IXAudio2::SetDebugConfiguration. Os valores passados para o método IXAudio2::SetDebugConfiguration sempre substituem quaisquer valores padrão que foram definidos no registro do Windows.

Suporte de depuração

Os recursos de depuração estão sempre disponíveis para XAUDIO2 no Windows 8.x, Windows 10, Windows 11 e ao usar o pacote XAudio2Redist.

Para as versões herdadas do SDK do DirectX do XAUDIO2, você deve usar XAUDIO2_DEBUG_ENGINE ao criar o objeto XAUDIO2 com XAudio2Create e o sistema deve ter o DirectX SDK Developer Runtime instalado para que a depuração seja suportada.

Ativando o Rastreamento de Eventos para Windows (ETW) para XAudio2

Com o XAudio 2.8 ou posterior, todas as informações de depuração são registradas via ETW. Para habilitar o registro desses eventos, use as seguintes etapas:

1. Procure por "Event Viewer" no seu sistema local e execute esta aplicação.
2. Selecione Ver na barra de menus e marque a opção Mostrar Registos Analíticos e de Depuração.
3. Usando a visualização em árvore, selecione Logs de Aplicativos e Serviços / Microsoft / Windows / XAudio2.
4. Clique com o botão direito do mouse em de log de depuração do Microsoft Windows XAudio2 e selecione "Propriedades".
5. Clique na caixa de seleção em "Ativar log" e clique em "OK". Opcionalmente, você pode alterar o local do log que é padrão para %SystemRoot%\System32\Winevt\Logs\Microsoft-Windows-XAudio2%4Debug.etl.

Execute seus cenários normalmente e, quando quiser ver a atividade recente, abra o arquivo de log ETL e procure eventos. Há uma série de ferramentas que você pode usar, incluindo o Visualizador de Eventos via "Abrir log salvo..." no painel Ações.

Para obter mais informações, consulte Rastreamento de Eventos.

Tópicos relacionados

Instalações de depuração

Referência de Programação XAudio2