Compartir a través de

Servicios de depuración de XAudio2

  • Artículo

La versión de depuración del motor XAudio2 valida los parámetros y proporciona mensajes de error y advertencia detallados.

Establecimiento del nivel de registro de depuración en tiempo de ejecución

Puede establecer el nivel de información de depuración que muestra XAudio2 en cualquier momento rellenando una estructura de XAUDIO2_DEBUG_CONFIGURATION con las marcas para el nivel de registro deseado y, a continuación, pasar la estructura al método IXAudio2::SetDebugConfiguration . Los valores pasados al método IXAudio2::SetDebugConfiguration siempre invalidan los valores predeterminados establecidos en el Registro de Windows.

Compatibilidad con depuración

Las instalaciones de depuración siempre están disponibles para XAUDIO2 en Windows 8.x, Windows 10, Windows 11 y al usar el paquete XAudio2Redist.

Para las versiones heredadas del SDK de DirectX de XAUDIO2, debe usar XAUDIO2_DEBUG_ENGINE al crear el objeto XAUDIO2 con XAudio2Create y el sistema debe tener instalado el entorno de ejecución para desarrolladores del SDK de DirectX para que se admita la depuración.

Habilitación del seguimiento de eventos para Windows (ETW) para XAudio2

Con XAudio 2.8 o posterior, toda la información de depuración se registra a través de ETW. Para habilitar el registro de estos eventos, siga estos pasos:

  1. Busque "Visor de eventos" en el sistema local y ejecute esta aplicación.
  2. Seleccione Ver en la barra de menús y establezca la marca de verificación en Mostrar registros analíticos y de depuración.
  3. Con la vista de árbol, seleccione Registros de aplicaciones y servicios / Microsoft / Windows / XAudio2.
  4. Haga clic con el botón derecho en el registro de depuración de Microsoft Windows XAudio2 y seleccione "Propiedades".
  5. Haga clic en la casilla "Habilitar registro" y presione "Aceptar". Opcionalmente, puede cambiar la ubicación del registro que tiene %SystemRoot%\System32\Winevt\Logs\Microsoft-Windows-XAudio2%4Debug.etlcomo valor predeterminado .

Ejecute los escenarios de forma normal y, cuando desee ver la actividad reciente, abra el archivo de registro ETL y busque eventos. Hay varias herramientas que puede usar, incluida la Visor de eventos a través de "Abrir registro guardado..." en el panel de acciones.

Para obtener más información, vea Seguimiento de eventos.

Depuración de instalaciones

Referencia de programación de XAudio2