Metodo IXAudio2EngineCallback::OnCriticalError (xaudio2.h)

Chiamato se si verifica un errore di sistema critico che richiede che XAudio2 venga chiuso e riavviato.

Sintassi

void OnCriticalError(
  HRESULT Error
);

Parametri

Error

Codice di errore restituito da XAudio2.

Valore restituito

nessuno

Osservazioni

Se si specifica l'ID di un dispositivo specifico nel parametro szDeviceId a IXAudio2::CreateMasteringVoice o si usa il flag XAUDIO2_NO_VIRTUAL_AUDIO_CLIENT, si verificherà un errore critico e OnCriticalError viene generato se il dispositivo di rendering WASAPI sottostante non è disponibile. Ciò può verificarsi quando un visore o un altoparlante è scollegato o quando un dispositivo audio USB viene rimosso, ad esempio. Una volta verificato un errore critico, l'elaborazione audio si arresta e tutte le ulteriori chiamate a XAudio2 hanno esito negativo. L'unico modo per ripristinare in questa situazione consiste nel rilasciare l'istanza XAudio2 e crearne uno nuovo.

Se è stato specificato il parametro NULL o szDeviceId a IXAudio2::CreateMasteringVoice, il sistema usa un client audio virtuale per rappresentare l'endpoint audio. In questo caso, se il dispositivo di rendering WASAPI sottostante non è disponibile, il sistema seleziona automaticamente un nuovo dispositivo di rendering audio per il rendering, l'elaborazione audio continua e OnCriticalError non viene generato.

Nella famiglia di dispositivi mobili viene sempre usato un client audio virtuale e OnCriticalError non viene mai generato, indipendentemente dai valori forniti da CreateMasteringVoice.

Per informazioni sui metodi di interfaccia IXAudio2EngineCallback , vedere la sezione Callback XAudio2 .

Requisiti della piattaforma

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

Requisiti

Piattaforma di destinazione	Windows
Intestazione	xaudio2.h

Vedi anche

IXAudio2EngineCallback

Callback di XAudio2