Partager via


IXAudio2EngineCallback::OnCriticalError, méthode (xaudio2.h)

Appelé si une erreur système critique se produit qui nécessite la fermeture et le redémarrage de XAudio2.

Syntaxe

void OnCriticalError(
  HRESULT Error
);

Paramètres

Error

Code d’erreur retourné par XAudio2.

Valeur de retour

None

Remarques

Si vous fournissez l’ID d’un appareil spécifique dans le paramètre szDeviceId à IXAudio2::CreateMasteringVoice ou que vous utilisez l’indicateur XAUDIO2_NO_VIRTUAL_AUDIO_CLIENT, une erreur critique se produit et OnCriticalError est déclenché si l’appareil de rendu WASAPI sous-jacent devient indisponible. Cela peut se produire lorsqu’un casque ou un haut-parleur est débranché ou lorsqu’un périphérique audio USB est supprimé, par exemple. Une fois qu’une erreur critique s’est produite, le traitement audio s’arrête et tous les autres appels à XAudio2 échouent. La seule façon de récupérer dans cette situation consiste à libérer le instance XAudio2 et à en créer un nouveau.

Si vous avez spécifié le paramètre NULL ou szDeviceId à IXAudio2::CreateMasteringVoice, le système utilise un client audio virtuel pour représenter le point de terminaison audio. Dans ce cas, si le périphérique de rendu WASAPI sous-jacent devient indisponible, le système sélectionne automatiquement un nouveau périphérique de rendu audio pour le rendu, le traitement audio continue et OnCriticalError n’est pas déclenché.

Sur la famille d’appareils mobiles, un client audio virtuel est toujours utilisé et OnCriticalError n’est jamais déclenché, quelles que soient les valeurs que vous fournissez à CreateMasteringVoice.

Pour plus d’informations sur les méthodes d’interface IXAudio2EngineCallback , consultez la section Rappels XAudio2 .

Configuration requise pour la plateforme

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8) ; Kit de développement logiciel (SDK) DirectX (XAudio 2.7)

Spécifications

   
Plateforme cible Windows
En-tête xaudio2.h

Voir aussi

IXAudio2EngineCallback

Rappels XAudio2