Partager via


IXAudio2Voice ::D estroyVoice, méthode (xaudio2.h)

Détruit la voix. Si nécessaire, arrête la voix et la supprime du graphique XAudio2.

Syntaxe

\\ void DestroyVoice();

Valeur renvoyée

Cette méthode ne retourne pas de valeur.

Notes

Si une autre voix envoie actuellement de l’audio à cette voix, la méthode échoue.

DestroyVoice attend que le thread de traitement audio soit inactif, ce qui peut prendre un peu de temps (généralement pas plus de quelques millisecondes). Cela est nécessaire pour garantir que la voix n’effectuera plus de rappels ou de données audio, afin que l’application puisse libérer ces ressources en toute sécurité dès le retour de l’appel.

Pour éviter les interruptions de thread de titre d’un appel DestroyVoice bloquant, l’application peut détruire les voix sur un thread non critique distinct, ou l’application peut utiliser des stratégies de regroupement de voix pour réutiliser les voix au lieu de les détruire. Notez que les voix ne peuvent être réutilisées qu’avec l’audio qui a le même format de données et le même nombre de canaux que la voix a été créée. Une voix peut lire des données audio avec des fréquences d’échantillonnage différentes de celles de la voix en appelant IXAudio2SourceVoice ::SetFrequencyRatio avec un paramètre de ratio approprié.

Il n’est pas valide d’appeler DestroyVoice à partir d’un rappel (autrement dit, IXAudio2EngineCallback ou IXAudio2VoiceCallback).

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)

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête xaudio2.h

Voir aussi

IXAudio2Voice