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 |