Compartilhar via

Instalações de depuração do XAudio2

  • Artigo

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

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 XAUDIO2_DEBUG_CONFIGURATION com os sinalizadores para o nível de log desejado e, em seguida, passar a estrutura para o método IXAudio2::SetDebugConfiguration . Os valores passados para o método IXAudio2::SetDebugConfiguration sempre substituem todos os valores padrão que foram definidos no Registro do Windows.

Suporte de depuração

As instalações de depuração estão sempre disponíveis para XAUDIO2 em 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 Runtime do Desenvolvedor do SDK do DirectX instalado para que a depuração tenha suporte.

Habilitando o ETW (Rastreamento de Eventos para Windows) 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 em log desses eventos, use as seguintes etapas:

  1. Pesquise "Visualizador de Eventos" em seu sistema local e execute este aplicativo.
  2. Selecione Exibir na barra de menus e defina a marca de marcar em Mostrar Logs de Análise e Depuração.
  3. Usando o modo de exibição de árvore, selecione Logs de Aplicativos e Serviços/Microsoft/Windows/XAudio2.
  4. Clique com o botão direito do mouse no log de depuração do Microsoft Windows XAudio2 e selecione "Propriedades".
  5. Clique na caixa de marcar em "Habilitar Log" e clique em "OK". Opcionalmente, você pode alterar o local do log que usa %SystemRoot%\System32\Winevt\Logs\Microsoft-Windows-XAudio2%4Debug.etlcomo padrão .

Execute seus cenários normalmente e, quando quiser ver a atividade recente, abra o arquivo de log ETL e procure eventos. Há várias ferramentas que você pode usar, incluindo a Visualizador de Eventos por meio de "Abrir Log Salvo..." no painel ações.

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

Instalações de depuração

Referência de programação em XAudio2