Método IXAudio2EngineCallback::OnCriticalError (xaudio2.h)

Se llama si se produce un error crítico del sistema que requiere que XAudio2 se cierre y reinicie.

Sintaxis

void OnCriticalError(
  HRESULT Error
);

Parámetros

Error

Código de error devuelto por XAudio2.

Valor devuelto

None

Observaciones

Si proporciona el identificador de un dispositivo específico en el parámetro szDeviceId a IXAudio2::CreateMasteringVoice o usa la marca XAUDIO2_NO_VIRTUAL_AUDIO_CLIENT, se producirá un error crítico y onCriticalError se generará si el dispositivo de representación WASAPI subyacente deja de estar disponible. Esto puede ocurrir cuando un auricular o altavoz está desconectado o cuando se quita un dispositivo de audio USB, por ejemplo. Una vez que se ha producido un error crítico, el procesamiento de audio se detiene y se producen errores en todas las llamadas adicionales a XAudio2. La única manera de recuperarse en esta situación es liberar la instancia de XAudio2 y crear una nueva.

Si especificó el parámetro NULL o szDeviceId en IXAudio2::CreateMasteringVoice, el sistema usa un cliente de audio virtual para representar el punto de conexión de audio. En este caso, si el dispositivo de representación WASAPI subyacente deja de estar disponible, el sistema selecciona automáticamente un nuevo dispositivo de representación de audio para la representación, el procesamiento de audio continúa y OnCriticalError no se genera.

En la familia de dispositivos móviles, siempre se usa un cliente de audio virtual y onCriticalError nunca se genera, independientemente de los valores que proporcione a CreateMasteringVoice.

Para obtener información sobre los métodos de interfaz IXAudio2EngineCallback , consulte la sección Devoluciones de llamada de XAudio2 .

Requisitos de la plataforma

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); SDK de DirectX (XAudio 2.7)

Requisitos

Plataforma de destino	Windows
Encabezado	xaudio2.h

Consulte también

IXAudio2EngineCallback

Devoluciones de llamadas de XAudio2