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

  • Artigo

Chamado se ocorrer um erro crítico do sistema que exige que XAudio2 seja fechado e reiniciado.

Sintaxe

void OnCriticalError(
  HRESULT Error
);

Parâmetros

Error

Código de erro retornado por XAudio2.

Valor retornado

Nenhum

Comentários

Se você fornecer a ID de um dispositivo específico no parâmetro szDeviceId para IXAudio2::CreateMasteringVoice ou usar o sinalizador XAUDIO2_NO_VIRTUAL_AUDIO_CLIENT, ocorrerá um erro crítico e OnCriticalError será gerado se o dispositivo de renderização WASAPI subjacente ficar indisponível. Isso pode ocorrer quando um fone de ouvido ou alto-falante estiver desconectado ou quando um dispositivo de áudio USB for removido, por exemplo. Depois que ocorre um erro crítico, o processamento de áudio é interrompido e todas as chamadas adicionais para XAudio2 falham. A única maneira de se recuperar nessa situação é liberar a instância XAudio2 e criar uma nova.

Se você especificou o parâmetro NULL ou szDeviceId para IXAudio2::CreateMasteringVoice, o sistema usará um Cliente de Áudio Virtual para representar o ponto de extremidade de áudio. Nesse caso, se o dispositivo de renderização WASAPI subjacente ficar indisponível, o sistema selecionará automaticamente um novo dispositivo de renderização de áudio para renderização, o processamento de áudio continuará e OnCriticalError não será gerado.

Na família de dispositivos móveis, um Cliente de Áudio Virtual é sempre usado e OnCriticalError nunca é gerado, independentemente dos valores que você fornece a CreateMasteringVoice.

Para obter informações sobre os métodos de interface IXAudio2EngineCallback , consulte a seção Retornos de chamada XAudio2 .

Requisitos da plataforma

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

Requisitos

   
Plataforma de Destino Windows
Cabeçalho xaudio2.h

Confira também

IXAudio2EngineCallback

Retorno de chamadas XAudio2