Método IXAudio2EngineCallback::OnCriticalError (xaudio2.h)
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 |